Google Play-Entwickler-APIs

Übersicht

Die Google Play Console bietet eine Reihe von REST-basierten Webdienst-APIs, mit denen du Veröffentlichungs-, Berichts- und andere App-Verwaltungsfunktionen direkt für deine App ausführen kannst.

Nicht alle Entwickler müssen diese Entwickler-APIs verwenden. In den meisten Fällen können Sie Ihre Apps weiterhin direkt über die Google Play Console verwalten. Wenn du jedoch eine große Anzahl von APKs verwalten oder Nutzerkäufe und ‑abos im Blick behalten musst, können diese APIs nützlich sein.

Leistungsumfang

Mit den Google Play Developer APIs kannst du dich auf das Design und die Entwicklung deiner App konzentrieren und musst weniger Zeit und Aufwand für die Verwaltung deiner Releases aufwenden, auch wenn du in neue Märkte expandierst.

Die Google Play Console enthält eine Reihe von APIs, mit denen Sie Ihre App verwalten können:

  • Mit der Publishing API können Sie Apps hochladen und veröffentlichen sowie andere Aufgaben im Zusammenhang mit der Veröffentlichung ausführen.
  • Mit der Subscriptions and In-App Purchases API können Sie In-App-Käufe und Abos verwalten. (Diese API wurde früher als „Purchase Status API“ bezeichnet.)
  • Mit der Reporting API können Sie Informationen zur Qualität Ihrer App aus Android Vitals abrufen.
  • Mit der Reply to Reviews API können Sie Rezensionen zu Ihrer App abrufen und darauf antworten.
  • Mit der Permissions API können Sie die Berechtigungsverwaltung in der Play Console automatisieren.
  • Mit der Play Games Services Management API können Sie REST-Aufrufe ausgeben, um die Metadaten, die den Google Play Games-Dienste-Funktionen zugrunde liegen, programmatisch zu steuern.
  • Die Voided Purchases API stellt eine Liste von Bestellungen bereit, die mit Käufen verknüpft sind, die ein Nutzer storniert hat.

Erste Schritte

Informationen zu den ersten Schritten mit den Google Play Developer APIs finden Sie in der Dokumentation zu den ersten Schritten.

Publishing API

Mit der Publishing API können Sie häufige Aufgaben im Zusammenhang mit der App-Bereitstellung automatisieren. Sie bietet Funktionen, die denen ähneln, die Entwicklern über die Play Console zur Verfügung stehen, z. B.:

  • Neue Versionen einer App hochladen
  • Apps veröffentlichen, indem APKs verschiedenen Tracks zugewiesen werden (Alpha, Beta, gestaffelter Roll-out oder Produktion)
  • Google Play Store-Einträge erstellen und ändern, einschließlich lokalisiertem Text und Grafiken sowie Screenshots für mehrere Geräte

Diese Aufgaben werden mit der Funktion edits ausgeführt, die einen transaktionalen Ansatz für Änderungen verwendet. So können Sie mehrere Änderungen in einer einzigen Entwurfsbearbeitung bündeln und dann alle Änderungen auf einmal übernehmen. (Keine der Änderungen wird wirksam, bis die Bearbeitung übernommen wurde.)

Best Practices

  • Begrenzen Sie die Anzahl der App-Updates. Veröffentlichen Sie Alpha- oder Beta-Updates nicht häufiger als einmal pro Tag. Produktions-Apps sollten noch seltener aktualisiert werden. Jedes Update kostet Ihre Nutzer Zeit und möglicherweise Geld. Wenn du zu häufig aktualisierst, ignorieren Nutzer die Updates möglicherweise oder deinstallieren das Produkt sogar.

Subscriptions and In-App Purchases API

Mit der Subscriptions and In-App Purchases API kannst du den Katalog deiner App mit In-App-Produkten und Abos verwalten. Außerdem können Sie mit der Subscriptions and In-App Purchases API die Details eines Kaufs schnell über eine standardmäßige GET-Anfrage abrufen.

In der Anfrage gibst du Informationen zum Kauf an: den Namen des App-Pakets, die Kauf- oder Abo-ID und das Kauf-Token. Der Server antwortet mit einem JSON-Objekt, das die zugehörigen Kaufdetails, den Bestellstatus, die Entwicklernutzlast und andere Informationen enthält.

Sie können diese API auf verschiedene Arten verwenden, z. B.:

  • Berichte zu einzelnen Bestellungen erstellen und diese abgleichen.
  • Käufe und Ablaufdaten von Abos überprüfen
  • Informationen zu stornierten Bestellungen und Bestätigung, ob In-App-Produkte genutzt wurden, einschließlich der Information, ob sie vor der Stornierung genutzt wurden.

Best Practices

  • Speichere Aboinformationen auf deinem Server, um unnötige API-Aufrufe zu vermeiden. Wenn Ihre App ein Abo überprüfen muss, sollten Sie die im Cache gespeicherten Informationen auf Ihrem Server verwenden, anstatt den API-Aufruf an Google zu wiederholen.
  • Es gibt zwei Szenarien, in denen dein sicherer Server die Google Play Developer API verwenden sollte, um Aboinformationen abzurufen:
    • Dein Server erhält ein neues, bisher unbekanntes Kaufftoken.
    • Dein Server erhält eine Entwicklerbenachrichtigung in Echtzeit (Real-time developer notification, RTDN), die angibt, dass du das Kaufftoken verwenden musst, um die neuen Aboinformationen abzurufen.
  • Fragen Sie den Abostatus nicht regelmäßig über die API ab. Rufen Sie die API beispielsweise nicht täglich auf, um jedes Abo zu prüfen.
  • Da du eine RTDN erhältst, wenn das Abo abläuft oder verlängert wird, musst du keinen API-Aufruf basierend auf der geplanten Ablaufzeit planen.

Reporting API

Die Reporting API ist für Entwickler gedacht, die automatisierte Workflows auf Grundlage von Play Console-Daten erstellen möchten, oder für Entwickler, die Play Console-Daten für interne Geschäftsberichte und ‑analysen verwenden, möglicherweise zusammen mit anderen Datasets. Über die API erhältst du programmatischen Zugriff auf Daten und Messwerte auf App-Ebene für die interne Berichterstellung, Analyse und Automatisierung.

Die Reporting API bietet Zugriff auf Android Vitals-Daten, einschließlich Absturzrate, ANR-Rate, Reaktivierungs- und Wakelock-Problemen sowie Fehler-Stacktraces.

Best Practices

Reply to Reviews API

Mit der Reply to Reviews API können Sie Nutzerfeedback zu Ihrer App abrufen und darauf antworten. Mit dieser API können Sie direkt in Ihrem vorhandenen Kundensupport-Toolkit, z. B. einem CRM-System, mit Nutzern interagieren.

Mit der Reply to Reviews API kannst du nur auf Feedback zu Produktionsversionen deiner App zugreifen. Wenn du Feedback zu Alpha- oder Betaversionen deiner App sehen möchtest, verwende stattdessen die Google Play Console. Beachten Sie außerdem, dass die API nur Rezensionen mit Kommentaren anzeigt. Wenn ein Nutzer deine App bewertet, aber keinen Kommentar hinterlässt, ist sein Feedback nicht über die API zugänglich.

Permissions API

Mit der Permissions API können Entwickler die Berechtigungsverwaltung in der Play Console automatisieren. So können Sie flexibel steuern, wer Zugriff auf Ihr Entwicklerkonto hat, ohne dass Sie manuell eingreifen müssen.

Mit der Permissions API können Sie administrative Funktionen ausführen, z. B.:

  • Entfernen des Zugriffs von Nutzern, wenn sie Ihr Unternehmen verlassen.
  • Zugriff auf eine App gewähren, wenn ein Nutzer dem entsprechenden Team beitritt.

Voided Purchases API

Die Voided Purchases API stellt eine Liste von Bestellungen bereit, die mit Käufen verknüpft sind, die ein Nutzer storniert hat. Anhand der Informationen in dieser Liste kannst du ein Widerrufssystem implementieren, das verhindert, dass der Nutzer auf Produkte aus diesen Bestellungen zugreift.

Diese API gilt für einmalige In-App-Bestellungen und App-Abos.

Ein Kauf kann auf folgende Weise storniert werden:

  • Der Nutzer beantragt eine Erstattung für seine Bestellung.
  • Der Nutzer storniert seine Bestellung.
  • Eine Bestellung wird zurückgebucht.
  • Der Entwickler storniert die Bestellung oder erstattet den Kaufpreis. Hinweis: In der Voided Purchases API werden nur widerrufene Bestellungen angezeigt. Wenn der Entwickler eine Erstattung veranlasst, ohne die Option „Widerrufen“ festzulegen, werden die Bestellungen nicht in der API angezeigt.
  • Google storniert die Bestellung oder erstattet den Betrag.

Durch die Verwendung dieser API trägst du dazu bei, dass alle Nutzer deiner App ein ausgewogeneres und faireres Erlebnis haben, insbesondere wenn es sich bei deiner App um ein Spiel handelt.