Bevor Sie API-Aufrufe starten können, müssen Sie den API-Zugriff auf Ihr Google Play-Entwicklerkonto einrichten. Dazu sind Änderungen sowohl in der Google Play Console als auch in der Google Cloud Console erforderlich. In der folgenden Anleitung wird beschrieben, wie Sie die Google Play Developer API verwenden können.
- Erstellen Sie ein Google Cloud-Projekt.
- Aktivieren Sie die Google Play Developer API für Ihr Google Cloud-Projekt.
- Richten Sie ein Dienstkonto mit den entsprechenden Google Play Console-Berechtigungen für den Zugriff auf die Google Play Developer API ein.
Google Cloud-Projekt erstellen
Sie können diesen Schritt überspringen, wenn Sie bereits ein Google Cloud-Projekt haben, das Sie verwenden möchten.
Erstellen Sie ein Projekt in der Google Cloud Console.
Weitere Informationen zu Google Cloud-Projekten finden Sie unter Projekte erstellen und verwalten.
API aktivieren
Nachdem Sie das Google Cloud-Projekt eingerichtet haben, müssen Sie die Google Play Developer API für dieses Projekt aktivieren.
So aktivieren Sie die Google Play Developer API:
- Rufen Sie in der Google Cloud Console die Seite Google Play Developer API auf.
- Klicken Sie auf Aktivieren.
OAuth und Dienstkonten konfigurieren
Sie müssen den Zugriff auf die Google Play Developer API mit einem OAuth-Client oder einem Dienstkonto konfigurieren. In den meisten Fällen sollten Sie ein Dienstkonto für den Zugriff auf die API verwenden.
Dienstkonten müssen in einer sicheren Umgebung wie Ihrem Server verwendet werden. Die Anmeldedaten des Dienstkontos müssen sicher verwaltet werden, damit sie nicht für Personen sichtbar sind, die nicht zur Verwendung der API berechtigt sind.
Die OAuth-Client-ID sollte verwendet werden, wenn Sie im Namen eines einzelnen Nutzers auf die API zugreifen müssen. Wenn Ihre Website beispielsweise im Namen des Nutzers über den Webclient auf die Google Play Developer API zugreifen muss, können Sie die Client-ID verwenden. Der Nutzer wird mit seinem Google-Konto anstelle des Dienstkontos authentifiziert. So können Sie API-Aufrufe im Namen eines Nutzers ausführen, ohne die Anmeldedaten des Dienstkontos zu gefährden.
- Dienstkonto: Ein sicherer Softwaredienst greift auf die API zu (am häufigsten)
- OAuth-Clients: Ein Nutzer greift auf die API zu
Dienstkonto verwenden
Sie können ein Dienstkonto in der Google Play Console erstellen.
- Rufen Sie in der Google Cloud Console Dienstkonten auf.
- Klicken Sie auf Dienstkonto erstellen und folgen Sie der Anleitung.
- Rufen Sie in der Google Play Console die Seite Nutzer und Berechtigungen auf.
- Klicken Sie auf Neue Nutzer einladen.
Geben Sie eine E-Mail-Adresse für Ihr Dienstkonto in das Feld „E-Mail-Adresse“ ein und gewähren Sie die erforderlichen Rechte zum Ausführen von Aktionen.
Wenn Sie die Google Play Billing APIs verwenden möchten, müssen Sie die folgenden Berechtigungen erteilen:
- Finanzdaten, Bestellungen und Antworten aus der Kündigungsumfrage ansehen
- Bestellungen und Abos verwalten
Klicken Sie auf Nutzer einladen.
An diesem Punkt sollten Sie über das Dienstkonto auf die Google Play Developer API zugreifen können. Weitere Informationen finden Sie unter OAuth 2.0 für Server-zu-Server-Anwendungen verwenden.
OAuth-Clients verwenden
Mit einem OAuth-Client können Sie Nutzern erlauben, Aktionen mit der API unter ihren eigenen Anmeldedaten auszuführen. Die Aktionen eines Nutzers sind auf die Aktionen beschränkt, die über die Seite Nutzer und Berechtigungen in der Google Play Console zulässig sind.
Bevor Sie OAuth-Clients erstellen können, müssen Sie Branding-Informationen für Ihr Produkt konfigurieren. Weitere Informationen finden Sie unter OAuth-Zustimmungsbildschirm einrichten.
- Rufen Sie in der Google Cloud Console die Seite OAuth-Zustimmungsbildschirm auf.
- Folgen Sie der Anleitung, um einen OAuth-Zustimmungsbildschirm zu erstellen.
So erstellen Sie einen OAuth-Client:
- Wechseln Sie in der Google Cloud Console zu Anmeldedaten.
- Klicken Sie auf „Anmeldedaten erstellen“ > „OAuth-Client-ID“.
- Wählen Sie den Anwendungstyp aus und folgen Sie der Anleitung.
Weitere Informationen
Die folgenden Tipps und Tricks sollen Ihnen den Einstieg in die API-Nutzung bei Google Play erleichtern.
Entwickler-ID abrufen
Für einige APIs müssen Sie eine Entwickler-ID aus der Google Play Console angeben. Das ist eine lange Nummer, die bei der Erstellung Ihres Google Play-Entwicklerkontos zugewiesen wurde. Ihre Entwickler-ID finden Sie in der URL fast jeder Seite in der Google Play Console, z. B. auf der Seite API-Zugriff.
Betrachten Sie beispielsweise die folgende Google Play Console-URL:
https://play.google.com/console/developers/1234567890123456789/api-access
In der obigen URL wäre die Entwickler-ID 1234567890123456789.
Hinweis:Wenn eine App von einem Google Play-Entwicklerkonto in ein anderes übertragen wird, ändert sich die mit dieser App verknüpfte Entwickler-ID. Das bedeutet, dass Sie nach der Übertragung die Entwickler-ID für das neue Google Play-Entwicklerkonto in API-Aufrufen für diese App verwenden müssen.
Spezialisierte APIs
Die Google Play Developer API enthält mehrere spezielle APIs, mit denen Sie bestimmte Analysen für Ihre App durchführen können:
- Reply to Reviews API
- Hier können Sie Nutzerfeedback zu Ihrer App ansehen und darauf antworten.
- Voided Purchases API
- Damit können Sie den Zugriff auf In‑App-Produkte widerrufen, die mit Käufen verknüpft sind, die ein Nutzer storniert hat.
Clientbibliotheken
Wir haben Clientbibliotheken bereitgestellt, mit denen Sie programmatisch auf die REST APIs zugreifen können. Weitere Informationen finden Sie unter Clientbibliotheken und Codebeispiele.