Play Catalog API – Entwicklerleitfaden

Mit der Play Catalog API können Drittanbieter-App-Shops, die bei Google Play registriert sind, nach Aktualisierungen des Google Play-App-Katalogs 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 Aktualisierungen abzurufen, die seit dem letzten Export vorgenommen wurden:

  1. Nach Aktualisierungsereignissen 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 Katalogaktualisierungsereignissen suchen

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

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

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

Aktualisierungstypen

  • 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 beendet, sich von der Aufnahme in den Katalog abmeldet, gesperrt oder blockiert wird oder nicht mehr auf die USA ausgerichtet ist.

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 App-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.
    • Aktualisierungen 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 App-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.