Produktkatalog verwalten

In dieser Anleitung wird erläutert, wie du mit der Google Play Developer API einen Produktkatalog für deine Play-App erstellst und verwaltest.

Wenn du Produkte in deiner App über das Abrechnungssystem von Google Play verkaufen möchtest, musst du einen Katalog mit allen Produkten einrichten, die du deinen Nutzern zum Kauf anbieten möchtest. Das kannst du über die Play Console tun oder die Katalogverwaltung mit der Google Play Developer API automatisieren. Mithilfe der Automatisierung können Sie dafür sorgen, dass Ihr Katalog immer auf dem neuesten Stand ist, und für große Kataloge skaliert werden, bei denen eine manuelle Koordination nicht praktikabel ist. In dieser Anleitung erfahren Sie, wie Sie mit der Play Developer API einen Produktkatalog für Ihre Play-App erstellen und verwalten. Eine Anleitung zum Einrichten der Google Play Developer API für Ihre Backend-Integration finden Sie in unserem Leitfaden „Vorbereitungen“.

Catalog Management APIs

Weitere Informationen zu den verschiedenen Arten von Produkten, die du mit dem Abrechnungssystem von Google Play verkaufen kannst, findest du unter Überlegungen zu In-App-Produkttypen und Katalogen. Google bietet zwei Hauptgruppen von APIs für die Katalogverwaltung bei Google Play, die den beiden Hauptproduktkategorien entsprechen:

• Einmalkaufprodukte
• Aboprodukte

Einmalkaufprodukte

Mit dem Endpunkt inappproducts können Sie Einmalkaufprodukte von Ihrem Back-End aus verwalten. Dazu gehört das Erstellen, Aktualisieren und Löschen von Produkten sowie das Verwalten von Preisen und Verfügbarkeit. Je nachdem, wie du mit einmaligen Produktkäufen umgehst, modellierst du Konsumgüter, die beliebig oft gekauft werden können, oder dauerhafte Berechtigungen (die nicht zweimal vom selben Nutzer gewährt werden können). Sie können entscheiden, welche Einmalkaufprodukte kurzfristig nutzbar sind oder nicht.

Aboprodukte

Mit dem Endpunkt monetization.subscriptions können Sie Aboprodukte über Ihr Entwickler-Back-End verwalten. Sie können beispielsweise Abos erstellen, aktualisieren und löschen oder ihre regionale Verfügbarkeit und Preise festlegen. Zusätzlich zum monetization.subscriptions-Endpunkt stellen wir auch monetization.subscriptions.basePlans und monetization.subscriptions.basePlans.offers bereit, um die Basis-Abos und Angebote von Abos zu verwalten.

Hinweis :Die Inappproducts API enthält einige alte Funktionen zur Aboverwaltung, da bisher alle Google Play-Produkte über diesen Endpunkt verwaltet wurden. Du solltest diesen Endpunkt nicht mehr zum Verwalten von Aboprodukten verwenden und alle Integrationen für Aboveröffentlichungen zur neuen monetization.subscriptions API migrieren. Weitere Informationen zu dieser Einstellung finden Sie in unserem Blogpost.

Batchmethoden

Die Endpunkte inappproducts und monetization.subscriptions bieten eine Reihe von Batchmethoden, mit denen bis zu 100 Entitäten gleichzeitig in derselben Anwendung abgerufen oder verwaltet werden können.

Wenn Batchmethoden mit aktivierter Latenztoleranz verwendet werden, unterstützen sie einen höheren Durchsatz und sind besonders nützlich für Entwickler mit großem Katalog bei der anfänglichen Katalogerstellung oder dem Katalogabgleich.

Aktualisierungslatenz im Vergleich zum Durchsatz

Nachdem eine Produkterstellungs- oder Änderungsanfrage abgeschlossen ist, sind Änderungen aufgrund von Verzögerungen bei der Verarbeitung von Netzwerk- oder Back-Ends möglicherweise nicht sofort für Endnutzer auf ihren Geräten sichtbar. Standardmäßig sind alle Anfragen zu Produktänderungen latenzempfindlich. Dies bedeutet, dass sie für eine schnelle Weitergabe über Back-End-Systeme optimiert sind, was sich in der Regel innerhalb weniger Minuten auf Endnutzergeräten widerspiegelt. Die Anzahl solcher Änderungsanfragen ist jedoch pro Stunde begrenzt. Wenn Sie viele Produkte erstellen oder aktualisieren müssen (z. B. bei der anfänglichen Erstellung eines großen Katalogs), können Sie Batchmethoden verwenden, bei denen das Feld latencyTolerance auf PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT gesetzt ist. Dadurch wird der Aktualisierungsdurchsatz deutlich erhöht. Es kann bis zu 24 Stunden dauern, bis latenztolerante Updates auf Endnutzergeräte übertragen werden.

Kontingentkonfiguration

Wenn Sie die Play Developer API zur Verwaltung Ihres Produktkatalogs verwenden, sollten Sie mehrere Kontingentlimits beachten:

1. Die Google Play Developer APIs haben ein Standardlimit von 200.000 Abfragen pro Tag. Dieses Kontingentlimit gilt für die Zusammenfassung der Nutzung in allen Endpunkten, einschließlich Catalog Management APIs.
2. Endpunkte für Produktänderungen erzwingen außerdem ein Limit von 7.200 Abfragen pro Stunde. Dies ist ein einzelnes Limit für Einmalkaufprodukte und Abos sowie für alle Änderungsanfragen, einschließlich Erstellen, Aktualisieren, Aktivieren und Löschen. Aufrufe von Methoden zur Batchänderung zählen als eine Abfrage für dieses Kontingent, unabhängig von der Anzahl der enthaltenen einzelnen Anfragen oder ihrer Latenzsensibilität.
3. Latenzempfindliche Änderungen sind ebenfalls auf 7.200 Änderungen pro Stunde beschränkt. Bei Batchmethoden wird jede verschachtelte Änderungsanfrage für dieses Kontingent separat gezählt. Dieses Kontingent hat praktische Auswirkungen nur für Nutzer der Batch API, die latenzempfindliche Updates durchführt, da Kontingent 2 vor oder während des Kontingents erschöpft ist.

Hier sind einige Beispiele, die die Kontingentnutzung verschiedener Anfragen veranschaulichen:

• Eine einzelne get-Anfrage zum Abrufen eines Elements verbraucht 1 Token für Kontingent 1 und keine Tokens für Kontingent 2 und 3, da sie nur Änderungsendpunkte betreffen.
• Eine get-Batchanfrage zum Abrufen von bis zu 100 Elementen verbraucht ebenfalls 1 Token des Kontingents 1 und keine Tokens für Kontingent 2 und 3.
• Eine einzelne modification-Anfrage für ein Element verbraucht 1 Token von Kontingent 1 und 1 Token von Kontingent 2. Wenn die Anfrage latenzempfindlich ist, wird auch 1 Token des Kontingents 3 verbraucht. Da für Kontingent C dasselbe Limit wie für Kontingent 2 gilt, hat dies keine praktischen Auswirkungen auf Nutzer, die nur einzelne Änderungsmethoden verwenden.
• Eine modification-Batchanfrage für 100 latenztolerante Elemente verbraucht 1 Token von Kontingent 1 und 1 Token von Kontingent 2. Diese Kontingenteinrichtung sollte genügend Spielraum bieten, um Ihren Katalog auf dem neuesten Stand zu halten. Wenn Ihr Algorithmus dieses Kontingent jedoch nicht bewusst ist und diese Rate überschreitet, erhalten Sie möglicherweise bei jedem weiteren Aufruf einen Fehler.
• Eine modification-Batchanfrage für 100 latenzempfindliche Elemente verbraucht 1 Token von Kontingent 1, 1 Token von Kontingent 2 und 100 Tokens von Kontingent 3.

Nutzungsempfehlungen für die Catalog Management API

Durch die Einhaltung dieser Richtlinien optimieren Sie Ihre Interaktionen mit der API und sorgen für eine reibungslose und effiziente Katalogverwaltung.

Nutzung überwachen

Sie sollten über Prozesse mit intensiver Nutzung informiert sein. Beispielsweise verbrauchen Ihre Katalogverwaltungs-Endpunkte zu Beginn der Integration mit höherer Wahrscheinlichkeit mehr Kontingente, um den vollständigen Katalog zu erstellen. Dies kann sich möglicherweise auf die Produktionsnutzung anderer Endpunkte wie der Purchase Status API auswirken, wenn Sie das Gesamtnutzungslimit fast erreicht haben. Sie müssen Ihre Kontingentnutzung überwachen, um sicherzustellen, dass Sie die API-Kontingente nicht überschreiten. Es gibt mehrere Möglichkeiten, die Nutzung zu überwachen. Sie können beispielsweise das Kontingent-Dashboard der Google Cloud APIs oder ein anderes internes oder Drittanbieter-API-Monitoringtool Ihrer Wahl verwenden.

API-Kontingentnutzung optimieren

Die Optimierung der Ratennutzung wird dringend empfohlen, um die Wahrscheinlichkeit von API-Fehlern zu minimieren. Für eine effektive Implementierung empfehlen wir Folgendes:

• Die richtige Strategie für die Katalogverwaltung auswählen Sobald Sie das API-Kontingent kennen, müssen Sie die richtige Strategie für Ihre Anwendung auswählen, um Ihre Ziele für die Katalogverwaltung effizient zu erreichen.
• Führen Sie nur die Mindestanzahl von Aufrufen durch, die erforderlich ist, damit Ihre Änderungen übernommen werden.
• Senden Sie keine redundanten oder unnötigen Änderungsaufrufe an die APIs. Dazu müssen Sie möglicherweise ein Änderungsprotokoll in Ihrem Back-End-Katalog führen.
• Halten Sie das stündliche Limit von 7.200 Abfragen für Produktänderungen ein. Möglicherweise möchten Sie Synchronisierungsprozesse erstellen, bei denen Sie in kurzer Zeit eine große Anzahl von Produktänderungen vornehmen müssen (z. B. eine erste Katalogerstellung). Wenn Sie davon ausgehen, dass diese Prozesse das stündliche Limit überschreiten, implementieren Sie bei Bedarf Wartezeiten, um die Nutzung auf ein sicheres Niveau zu verlangsamen. Erwägen Sie die Verwendung von Batchmethoden mit latenztoleranten Updates, um einen höheren Durchsatz zu erzielen.
• Bereiten Sie die Skalierung proaktiv vor. Wenn Ihre Anwendung wächst, müssen Sie möglicherweise die Nutzung der API und der verschiedenen Endpunkte hochskalieren. Wie Sie Ihr Kontingent erhöhen können, wenn Sie sich der maximalen Nutzung nähern, können Sie in der Dokumentation zu den Google Play Developer API-Kontingenten nachlesen.
• Planen Sie umfangreiche Prozesse strategisch ein. Versuchen Sie, aufwendige Katalogprozesse um kritische Nutzungsspitzen herum zu planen. So können Sie es beispielsweise vermeiden, während Ihrer Spitzenverkaufszeiten eine vollständige Katalogsynchronisierung durchzuführen.

Fehlerbehandlungslogik für Kontingent hinzufügen

Unabhängig davon, wie effizient Sie Ihre Katalogverwaltungslogik erstellen, sollten Sie sie vor unerwarteten Kontingentlimits schützen, da das Tageskontingent von den Endpunkten geteilt wird, die in unabhängigen Modulen Ihrer Integration verwendet werden. Achten Sie darauf, Fehler bei der Kontingentdrosselung in die Fehlerbehandlung aufzunehmen, und implementieren Sie die entsprechenden Wartezeiten. Jeder Aufruf an Google Play Developer APIs generiert eine Antwort. Im Falle eines Aufruffehlers erhalten Sie eine Fehlerantwort, die einen HTTP-Antwortstatuscode und ein errors-Objekt mit weiteren Details zur Fehlerdomain und einer Debug-Nachricht enthält. Wenn Sie beispielsweise Ihr Tageslimit überschreiten, tritt möglicherweise ein Fehler wie dieser auf:

{
  "code" : 403,
  "errors" : [ {
    "domain" : "usageLimits",
    "message" : "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API
  Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxxx",
  "reason" : "dailyLimitExceeded",
  "extendedHelp" : "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxx"
  } ],
}

Implementierung der Katalogverwaltung

Entwickler verwenden die Veröffentlichungsendpunkte der Google Play Developer API, um ihren Katalog zwischen ihrem Backend und Google Play zu synchronisieren. Wenn dein Google Play-Katalog immer auf dem neuesten Stand ist und immer die neuesten Informationen aus deinem Back-End-Katalog enthält, ist das für eine bessere Nutzererfahrung von Vorteil. Beispiel:

• Du kannst die gesamte Liste der verfügbaren Angebote einsehen und Angebots- und Basis-Abo-Tags verwalten, um deine eigene Berechtigung und Angebotslogik zu beeinflussen.
• Du kannst die verschiedenen Preispunkte und Produktdetails prüfen, die Nutzer auf verschiedenen Plattformen sehen, und darauf achten, dass sie einheitlich sind.
• Bei der Verarbeitung neuer Käufe haben Sie Produktdetails in Ihrem Back-End zur Hand, ohne die Latenz und das Fehlerrisiko erhöhen zu müssen, indem Sie während nutzerkritischer Abläufe zusätzliche Aufrufe an die Google Play Developer API senden.

Beim Erstellen Ihres Produktkatalogs bei Google Play sind bestimmte Einschränkungen und Überlegungen zu beachten. Sobald Sie diese Einschränkungen verstanden haben und wissen, wie Sie Ihren Katalog strukturieren möchten, ist es an der Zeit, eine Synchronisierungsstrategie festzulegen.

Synchronisierungsstrategien für Kataloge

Über die Veröffentlichungsendpunkte der Google Play Developer API kannst du deinen Katalog bei Änderungen aktualisieren. Gelegentlich kann es erforderlich sein, regelmäßige Updates durchzuführen, bei denen Sie im selben Prozess eine Batterie mit Änderungen senden. Jeder Ansatz erfordert unterschiedliche Designentscheidungen. Jede Synchronisierungsstrategie eignet sich für bestimmte Anwendungsfälle besser als andere. Je nach Situation müssen Sie möglicherweise eine Reihe von Anforderungen haben, die beides erfordert. Manchmal möchten Sie ein Produkt aktualisieren, sobald Sie eine neue Änderung bemerken, z. B. um eine dringende Produktaktualisierung zu verarbeiten (d. h., ein falscher Preis muss so schnell wie möglich korrigiert werden). In anderen Fällen können Sie eine regelmäßige Hintergrundsynchronisierung verwenden, um sicherzustellen, dass Ihr Back-End und Ihr Play-Katalog immer konsistent sind. Informiere dich über einige häufige Anwendungsfälle, in denen du diese verschiedenen Strategien zur Katalogverwaltung implementieren möchtest.

Wann Sie Updates senden sollten, wenn sich Ihr lokaler Katalog ändert

Im Idealfall sollten Aktualisierungen erfolgen, sobald es eine Änderung am Produktkatalog Ihres Back-Ends gibt, um Diskrepanzen zu minimieren.

Diese Art von Updates ist in folgenden Fällen sinnvoll:

• Ihre Produkte müssen immer auf dem neuesten Stand sein.
• Sie müssen jeden Tag einige Änderungen an Ihren Produkten vornehmen.
• Sie müssen Produkte aktualisieren, die sich bereits in der Produktion befinden und verkauft werden.

Dieser Ansatz ist einfacher zu implementieren und ermöglicht es Ihnen, Ihren Katalog mit dem geringsten Diskrepanzfenster synchron zu halten.

Anwendungsfälle für regelmäßige Updates

Regelmäßige Aktualisierungen werden asynchron zur Produktversion auf Ihrem Back-End ausgeführt und sind in folgenden Fällen sinnvoll:

• Sie müssen nicht dafür sorgen, dass Ihre Produkte kurzfristig aktualisiert werden.
• Sie müssen Bulk-Aktualisierungen oder Abgleichprozesse planen.
• Sie verfügen bereits über ein Content- oder Catalog-Management-System, das Ihren Katalog kontinuierlich aktualisiert

Bei großen Katalogen sollten Sie die Verwendung von Batchmethoden mit latenztoleranten Updates in Betracht ziehen, um einen maximalen Durchsatz zu erzielen.

Hinweis :Du kannst Aktualisierungen an deinen Google Play-Produktkatalog sofort senden, nachdem Änderungen vorgenommen wurden. Das bedeutet aber nicht zwangsläufig, dass die Änderungen sofort in der App für deine Nutzer verfügbar sind. Aufgrund von Verzögerungen bei der Verarbeitung im Netzwerk oder im Backend kann es bei diesem Vorgang trotzdem zu einer gewissen Latenz kommen. Auch wenn regelmäßige Aktualisierungen mit einer gewissen Verzögerung durchgeführt werden, können sie so konzipiert werden, dass Ihr Katalog bei Bedarf häufig aktualisiert wird. Ihre Änderungen werden Nutzern mit einer ähnlichen Latenz wie bei Aktualisierungen nach Bedarf zur Verfügung gestellt. Darüber hinaus können Sie mit dem Feld latencyTolerance in Batchmethoden zwischen der Optimierung für eine schnelle Weitergabe von Updates oder einem höheren Durchsatz wählen. Letztendlich sollte sich die Wahl zwischen diesen beiden Optionen nach Ihren spezifischen Anforderungen und Einschränkungen richten.

Produktkatalog erstellen

Wenn Sie einen großen Katalog zum Hochladen bei Google Play haben, können Sie den anfänglichen Ladevorgang automatisieren. Diese Art von aufwendigen Prozessen funktioniert am besten, wenn eine periodische Strategie mit latenztoleranten Batchmethoden kombiniert wird.

Einmalkaufprodukte erstellen

Für die erstmalige Erstellung eines großen Katalogs mit einem einmaligen Produkt empfehlen wir die Verwendung der Methode inappproducts.batchUpdate. Dabei sollten das Feld allowMissing auf true und das Feld latencyTolerance auf PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT gesetzt sein. Dadurch wird die Zeit für die Erstellung des Katalogs im Rahmen der Kontingentlimits minimiert.

Für kleinere Kataloge können Sie die Methode inapp_products.insert verwenden. Alternativ können Sie die Methode inappproducts.update mit dem Parameter allowMissing verwenden, wie im Abschnitt zu Produktupdates beschrieben. Dieser Ansatz hat den Vorteil, dass das Skript nicht zustandsorientiert sein muss. Es kann dann neu gestartet werden, falls etwas schiefgehen sollte.

Aboprodukte erstellen

Zum Erstellen eines großen Abokatalogs empfehlen wir, die Methode monetization.subscriptions.batchUpdate zu verwenden. Dabei sollte das Feld allowMissing auf true und das Feld latencyTolerance auf PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT gesetzt sein. Dadurch wird die Zeit für die Erstellung des Katalogs im Rahmen der Kontingentlimits minimiert.

Für kleinere Abokataloge bietet die Play Developer API die Methode monetization.subscriptions.create. Alternativ können Sie Abos mithilfe der Methode monetization.subscriptions.update und dem Parameter allowMissing erstellen, wie im Abschnitt zu Produktupdates beschrieben.

Mit allen vorherigen Methoden werden Abos zusammen mit ihren Basis-Abos erstellt, die im Aboobjekt bereitgestellt werden. Diese Basis-Abos sind anfangs inaktiv. Zum Verwalten des Status von Basis-Abos können Sie den Endpunkt monetization.subscriptions.basePlans verwenden und ein Basis-Abo aktivieren, um es zum Kauf anzubieten. Außerdem kannst du mit dem Endpunkt monetization.subscriptions.basePlans.offers Angebote erstellen und verwalten.

Produktupdates

Mit den folgenden Methoden kannst du deine vorhandenen Produkte effizient ändern und dafür sorgen, dass dein Angebot auf die neuesten Anpassungen abgestimmt ist.

Einmalkaufprodukte aktualisieren

Für die Aktualisierung bestehender Einmalkaufprodukte stehen drei Methoden zur Verfügung.

• inappproducts.patch: Der Patch-Endpunkt wird verwendet, um eine Ressource teilweise zu aktualisieren. Das bedeutet, dass Sie bestimmte Felder aktualisieren können, die Sie im Anfragetext angeben. Der Patch-Endpunkt wird normalerweise verwendet, wenn Sie nur einige Felder einer Ressource aktualisieren müssen.
• inappproducts.update: Der Aktualisierungsendpunkt wird verwendet, um eine Ressource vollständig zu aktualisieren. Das bedeutet, dass Sie das gesamte Ressourcenobjekt im Anfragetext senden müssen. Der Aktualisierungsendpunkt wird in der Regel verwendet, wenn Sie alle Felder in einer Ressource aktualisieren müssen. Wenn der Parameter allowMissing auf true gesetzt ist und die angegebene Produkt-ID nicht bereits vorhanden ist, fügt der Endpunkt das Produkt ein, anstatt fehlschlagen zu lassen.
• inappproducts.batchUpdate: Dies ist eine Batchversion des Updateendpunkts, mit der Sie mehrere Produkte mit einer einzigen Abfrage ändern können. Verwenden Sie es zusammen mit dem Feld latencyTolerance, das auf PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT gesetzt ist, um einen höheren Durchsatz zu erzielen.

Aboprodukte aktualisieren

Sie können vorhandene Abos mit der Methode monetization.subscriptions.patch aktualisieren. Diese Methode verwendet die folgenden erforderlichen Parameter:

• packageName: Der Paketname der App, zu der das Abo gehört.
• productId: Die eindeutige Produkt-ID des Abos.
• regionsVersion: Die Konfigurationsversion der Region.

Wenn Sie nicht den allowMissing-Parameter verwenden, um ein neues Abo zu erstellen, müssen Sie den updateMask-Parameter angeben. Dieser Parameter ist eine durch Kommas getrennte Liste von Feldern, die Sie aktualisieren möchten.

Wenn Sie beispielsweise nur einen Eintrag für ein Aboprodukt aktualisieren möchten, geben Sie das Feld listings für den Parameter updateMask an.

Mit monetization.subscriptions.batchUpdate kannst du mehrere Abos gleichzeitig aktualisieren. Verwenden Sie es zusammen mit dem Feld latencyTolerance, das auf PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT gesetzt ist, um einen höheren Durchsatz zu erzielen.

Verwende den monetization.subscriptions.basePlans-Endpunkt, um Basis-Abos zu aktivieren, zu deaktivieren oder zu löschen oder Abonnenten zu den neuesten Preismodellen des Basis-Abos zu migrieren.

Außerdem kannst du die Angebote deiner Basis-Abos mit der Methode monetization.subscriptions.basePlans.offers.patch aktualisieren.

Katalogabgleich

Unabhängig davon, ob Sie Ihren Google Play-Katalog bei jeder Änderung des Back-End-Katalogs oder in regelmäßigen Abständen aktualisieren möchten, kann es bei einem Katalogverwaltungssystem oder einer Datenbank außerhalb des Google Play-Katalogs Situationen geben, in denen er nicht mit dem Katalog in Ihrer App-Konfiguration bei Play übereinstimmt. Dies kann an dringenden manuellen Katalogänderungen in der Console, einem Ausfall Ihres Katalogverwaltungssystems oder an einem Verlust Ihrer neuesten Daten liegen.

Sie können einen Katalogabgleichsprozess erstellen, um ein längeres Diskrepanzfenster zu vermeiden.

Berücksichtigung des Differenzsystems

Wir empfehlen, ein Diff-System zu erstellen, um Inkonsistenzen zu erkennen und die beiden Systeme abzugleichen. Hier sind einige Dinge, die Sie beim Erstellen eines Diff-Systems berücksichtigen sollten, um Ihre Kataloge synchron zu halten:

• Datenmodelle verstehen:Der erste Schritt besteht darin, die Datenmodelle des Entwickler-CMS und der Google Play Developer API zu verstehen. Dazu gehört auch, die verschiedenen Datentypen zu kennen, die in den einzelnen Systemen gespeichert werden, und zu wissen, wie die verschiedenen Datenelemente einander zugeordnet werden.
• Unterschiedsregeln definieren:Sobald Sie die Datenmodelle verstanden haben, müssen Sie die Differenzregeln definieren. Diese Regeln bestimmen, wie die Daten in den beiden Systemen verglichen werden. Beispielsweise kannst du Produkt-IDs abgleichen und wichtige Attribute des Abos sowie die zugehörigen Basis-Abos und Angebote vergleichen.
• Differenz-Algorithmus implementieren:Nachdem Sie die Diff-Regeln definiert haben, müssen Sie den Diff-Algorithmus implementieren. Dieser Algorithmus vergleicht die Daten aus den beiden Systemen gemäß den von Ihnen definierten Regeln. Zum Abrufen der Katalogdaten aus Google Play können Sie die Methoden inappproducts.list, inappproducts.batchGet, monetization.subscriptions.list und monetization.subscriptions.batchGet verwenden.
• Unterschiedsberichte erstellen:Mit dem Diff-Algorithmus wird ein Diff-Bericht erstellt. In diesem Bericht werden die Unterschiede zwischen den beiden Systemen aufgezeigt.
• Unterschiede ausgleichen:Nachdem Sie den Differenzbericht erstellt haben, müssen Sie sie beheben. Je nachdem, wie du deinen Katalog normalerweise aktualisierst, musst du eventuell die Daten in deinem CMS aktualisieren oder die Daten aufseiten von Google Play über die Katalogverwaltungsendpunkte der Developer API. Um abweichende Produkte abzugleichen, verwenden Sie die Aktualisierungsendpunkte, wie im Abschnitt zu Produktupdates beschrieben.

Produkte werden eingestellt

Die Google Play Developer API bietet mehrere Methoden, um Entwickler bei der Einstellung ihrer Produkte zu unterstützen: inappproducts.delete und inappproducts.batchDelete für Einmalkaufprodukte und monetization.subscriptions.delete für Abos. Die Einstellung eines Produkts kann in verschiedenen Szenarien erforderlich sein, z. B.:

• Es wurde versehentlich erstellt.
• Einstellung einer Funktion oder eines Dienstes

Wir empfehlen, die Einstellung von Produkten in Ihre Katalogverwaltungsstrategie aufzunehmen.

Einmalkaufprodukte einstellen

Wenn du Einmalkaufprodukte mit der Google Play Developer API löschen möchtest, musst du die Methode inappproducts.delete oder inappproducts.batchDelete verwenden.

Einstellung von Aboprodukten

Sie können Abos mit der Methode monetization.subscriptions.delete löschen. Ein Abo kann nicht mehr entfernt werden, sobald mindestens ein Basis-Abo aktiviert wurde.