Übersicht
Die Google Play Console bietet eine Reihe von REST-basierten Webdienst-APIs, mit denen Sie Veröffentlichungs-, Berichterstellungs- und andere Funktionen zur App-Verwaltung direkt für Ihre App ausführen können.
Nicht alle Entwickler müssen diese Entwickler-APIs verwenden – in den meisten Fällen kannst du deine Apps weiterhin direkt über die Google Play Console verwalten. Wenn Sie jedoch eine große Anzahl von APKs verwalten oder Nutzerkäufe und Abos erfassen müssen, können diese APIs nützlich sein.
Enthalten
Mit den Google Play Developer APIs kannst du dich ganz auf das Entwerfen und Entwickeln deiner App konzentrieren und musst weniger Zeit und Aufwand für die Verwaltung deiner Releases aufwenden, selbst wenn du neue Märkte erschließt.
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 veröffentlichungsbezogene Aufgaben ausführen.
- Mit der Subscriptions and In-App Purchases API kannst du In-App-Käufe und Abos verwalten. Diese API hieß früher „Purchase Status API“.
- Mit der Reporting API können Sie aus Android Vitals Informationen zur Qualität Ihrer App abrufen.
- Mit der Reply to Reviews API können Sie Rezensionen Ihrer App abrufen und beantworten.
- Mit der Permissions API kannst du die Berechtigungsverwaltung in der Play Console automatisieren.
- Mit der Play Games Services Management API können Sie REST-Aufrufe ausführen, um die Metadaten, die den Funktionen der Google Play-Spieldienste zugrunde liegen, programmatisch zu steuern.
- Die Voided Purchases API enthält eine Liste von Bestellungen, die mit Käufen verknüpft sind, die ein Nutzer für ungültig erklärt hat.
Erste Schritte
Informationen zu den ersten Schritten mit den Google Play Developer APIs finden Sie in der Dokumentation zum Einstieg.
Publishing API
Mit der Publishing API können Sie häufige Aufgaben im Zusammenhang mit der App-Bereitstellung automatisieren. Sie bietet ähnliche Funktionen wie die, die einem Entwickler in der Play Console zur Verfügung stehen, z. B.:
- Neue Versionen einer App hochladen
- Apps freigeben, indem APKs verschiedenen Tracks zugewiesen werden (Alpha, Beta, gestaffelter Roll-out oder Produktion)
- Google Play Store-Einträge erstellen und ändern, einschließlich lokalisierten Texten und Grafiken sowie Screenshots für mehrere Geräte
Diese Aufgaben werden mithilfe der Bearbeitungsfunktion ausgeführt, die einen transaktionalen Ansatz für das Vornehmen von Änderungen verfolgt. Auf diese Weise können Sie mehrere Änderungen in einer einzigen Entwurfsbearbeitung bündeln und die Änderungen dann gleichzeitig übernehmen. Die Änderungen werden erst wirksam, wenn für die Änderung ein Commit durchgeführt wird.
Best Practices
- Begrenzen Sie die Anzahl der App-Updates. Veröffentlichen Sie Alpha- oder Beta-Updates nicht häufiger als einmal täglich. Produktions-Apps sollten auch seltener aktualisiert werden. Jede Aktualisierung kostet Ihre Nutzer Zeit und möglicherweise Geld. Wenn Sie zu häufig Updates durchführen, ignorieren Nutzer Updates möglicherweise oder deinstallieren das Produkt.
Subscriptions and In-App Purchases API
Mit der Subscriptions and In-App Purchases API kannst du den Katalog der In-App-Produkte und Abos deiner App verwalten. Außerdem kannst du mit der Subscriptions and In-App Purchases API schnell die Details eines beliebigen Kaufs mithilfe einer GET-Standardanfrage abrufen.
In der Anfrage geben Sie Informationen zum Kauf an – den App-Paketnamen, die Kauf- oder Abo-ID und das Kauftoken. Der Server antwortet mit einem JSON-Objekt, das die zugehörigen Kaufdetails, den Bestellstatus, die Entwicklernutzlast und andere Informationen beschreibt.
Sie können diese API auf verschiedene Arten verwenden, z. B. für die Berichterstellung und den Abgleich einzelner Bestellungen sowie zum Überprüfen von Käufen und Ablaufzeit von Abos. Sie können die API auch verwenden, um mehr über stornierte Bestellungen zu erfahren und zu prüfen, ob In-App-Produkte bereits verbraucht wurden und ob sie vor der Stornierung genutzt wurden.
Best Practices
- Speichern Sie Aboinformationen auf Ihrem Server, um unnötige API-Aufrufe zu vermeiden. Wenn deine App ein Abo bestätigen muss, solltest du dich auf die im Cache deines Servers gespeicherten Informationen verlassen, 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:
- Ihr Server erhält ein neues Kauftoken, das bisher noch nicht erfasst wurde.
- Dein Server erhält eine Entwicklerbenachrichtigung in Echtzeit (Real-Time Developer Notification, RTDN), die besagt, dass du das Kauftoken verwenden musst, um die Informationen zum neuen Abo 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 Sie bei Ablauf oder Verlängerung des Abos eine Benachrichtigung erhalten, müssen Sie keinen API-Aufruf basierend auf der geplanten Ablaufzeit planen.
Reporting API
Die Reporting API ist für Entwickler gedacht, die anhand von Play Console-Daten automatisierte Workflows erstellen möchten oder die Play Console-Daten, möglicherweise neben anderen Datasets, für interne Geschäftsberichte und -analysen verwenden. Dadurch erhalten Sie programmatischen Zugriff auf Daten und Messwerte auf App-Ebene für interne Berichte, Analysen und Automatisierung.
Die Reporting API bietet Zugriff auf Android Vitals-Daten, einschließlich Absturzrate, ANR-Rate, Wakeup- und Wakelock-Probleme sowie Fehler-Stacktraces.
Best Practices
- Diese Version der Reporting API hat ein Standardlimit von 10 Abfragen pro Sekunde. Ihre Kontingentnutzung können Sie im Bereich „Kontingente“ der Google Cloud Console einsehen. Wenn Sie dieses Limit überschreiten müssen, können Sie über dieses Formular eine Kontingentanfrage senden.
Reply to Reviews API
Mit der Reply to Reviews API können Sie Nutzerfeedback zu Ihrer App ansehen und darauf antworten. Sie können diese API verwenden, um mit Nutzern direkt über Ihr bestehendes Kundensupport-Toolkit zu interagieren, z. B. in einem CRM-System.
Über die 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. In der API werden nur Rezensionen mit Kommentaren angezeigt. Wenn ein Nutzer deine App bewertet, aber keinen Kommentar abgibt, kann über die API nicht auf sein Feedback zugegriffen werden.
Permissions API
Mit der Berechtigungen API können Entwickler die Berechtigungsverwaltung in der Play Console automatisieren. So können Sie flexibel und ohne manuelle Schritte steuern, wer Zugriff auf Ihr Entwicklerkonto hat.
Mit der Berechtigungen-API können Sie unter anderem folgende administrative Aufgaben ausführen:
- Der Zugriff von Nutzern wird entfernt, wenn diese das Unternehmen verlassen.
- Zugriff auf eine App gewähren, wenn ein Nutzer dem entsprechenden Team beitritt.
Voided Purchases API
Die Voided Purchases API enthält eine Liste von Bestellungen, die mit Käufen verknüpft sind, die ein Nutzer storniert hat. Sie können Informationen aus dieser Liste verwenden, um ein Widerrufssystem zu implementieren, das den Nutzer am Zugriff auf Produkte aus diesen Bestellungen hindert.
Diese API kann für einmalige In-App-Bestellungen und App-Abos verwendet werden.
So können Sie einen Kauf für ungültig erklären:
- Der Nutzer fordert eine Erstattung für seine Bestellung an.
- Der Nutzer storniert die Bestellung.
- Eine Bestellung wird zurückgebucht.
- Der Entwickler storniert oder erstattet die Bestellung. Hinweis: In der Voided Purchases API werden nur widerrufene Bestellungen angezeigt. Wenn Entwickler Erstattungen erhalten, ohne die Option zum Widerrufen festzulegen, werden Bestellungen nicht in der API angezeigt.
- Google storniert oder erstattet die Bestellung.
Mit dieser API sorgen Sie für eine ausgewogenere und fairere Nutzererfahrung für alle Nutzer Ihrer App, insbesondere wenn es sich bei Ihrer App um ein Spiel handelt.