Play Catalog API – Entwicklerleitfaden

Mit der Play Catalog API können Drittanbieter-App-Shops, die bei Google Play registriert sind, nach Updates für den Google Play-App-Katalog suchen. Anrufer können Katalogdetails für Apps abrufen, die seit dem letzten täglichen Katalogexport geändert oder entfernt wurden.

Eine vollständige Liste der Endpunkte, Methoden und Ressourcenschemas finden Sie in der Play Catalog API-Referenz.

Vorbereitung

Sie müssen die Hauptanleitung für den Einstieg durcharbeiten, um Ihren API-Zugriff, Ihre Dienstanmeldedaten und Ihr Google Cloud-Projekt einzurichten, bevor Sie Aufrufe an die Play Catalog API senden können.

API-Design und -Architektur

Der Play Catalog-Export wird alle 24 Stunden generiert. Die Play Catalog API bietet einen untertägigen Abrufmechanismus, um Updates abzurufen, die seit dem letzten Export aufgetreten sind:

  1. Nach Update-Ereignissen suchen: Sie fragen appstorecatalog.recentUpdateEvents.list mit einem startTime und endTime Fenster ab, um herauszufinden, welche Paketnamen geändert oder gelöscht wurden.
  2. Detaillierte Ansichten abrufen: Für jeden geänderten Paketnamen rufen Sie appstorecatalog.recentAppViews.get auf, um die detaillierten CatalogAppView Metadaten abzurufen.

Die API ist schreibgeschützt und gibt nur Ereignisse zurück, die in den letzten 36 Stunden aufgetreten sind. Die API hat ein Limit von 2 Abfragen pro Sekunde, das zwischen beiden Methoden aufgeteilt wird.

1. Nach Katalogupdate-Ereignissen suchen

Rufen Sie die Methode appstorecatalog.recentUpdateEvents.list auf, um die Liste der Pakete abzurufen, die sich in einem bestimmten Zeitraum geändert haben.

Es werden nur Update-Ereignisse für infrage kommende Apps zurückgegeben. Infrage kommende Apps müssen folgende Voraussetzungen erfüllen:

  • Sie haben der Aufnahme in den Katalog für die Anruf-App-Shops zugestimmt.
  • Sie müssen im Google Play Store veröffentlicht und in den USA verfügbar sein.

Update-Typen

  • MODIFICATION: Wird ausgelöst, wenn eine infrage kommende App geändert, zum ersten Mal veröffentlicht wird, auf die USA ausgerichtet wird oder wenn die App neu in Ihren Katalog aufgenommen wurde.
  • DELETION: Wird ausgelöst, wenn eine App die Veröffentlichung aufgehoben wird, die Aufnahme in den Katalog deaktiviert wird, die App gesperrt oder blockiert wird oder die Ausrichtung auf die USA beendet wird.

2. Katalog-App-Ansichten abrufen

Für jedes Paket, das mit einem MODIFICATION Ereignis zurückgegeben wird, können Sie die aktualisierten Katalogdetails abrufen, indem Sie die appstorecatalog.recentAppViews.get Methode aufrufen.

3. Best Practices und Synchronisierung

Damit Ihre Katalogdatenbank im Shop konsistent bleibt, sollten Sie diese Integrationsrichtlinien beachten:

  • Tägliche Exportsynchronisierung: Importieren Sie die vollständige Liste der infrage kommenden Apps mit dem täglichen Katalogexport.
  • (Optional) Untertägige Synchronisierung: Rufen Sie den appstorecatalog.recentUpdateEvents.list Endpunkt regelmäßig (z.B. jede Minute) mit einem gleitenden Zeitfenster ab. Achten Sie darauf, die Paginierung mit nextPageToken zu verarbeiten.
    • Updates verarbeiten:
      • Rufen Sie für MODIFICATION-Ereignisse die aktualisierte CatalogAppView mit appstorecatalog.recentAppViews.get ab und aktualisieren Sie Ihre lokale Datenbank.
      • Entfernen Sie für DELETION-Ereignisse die App aus den Einträgen Ihres Shops oder blenden Sie sie für Nutzer aus.
    • Wiederholte Änderungsereignisse verarbeiten: Möglicherweise werden mehrere MODIFICATION-Ereignisse für dieselbe App angezeigt. Das bedeutet, dass die App im abgefragten Zeitraum mehrmals geändert wurde. appstorecatalog.recentAppViews.get gibt immer die App-Ansicht der letzten Änderung zurück.