Bevor Sie API-Aufrufe ausführen können, müssen Sie den API-Zugriff auf Ihr Google Play-Entwicklerkonto einrichten. Dies umfasst Änderungen sowohl in der Google Play Console als auch in der Google Cloud Console. In der folgenden Anleitung werden die Schritte beschrieben, die zur Verwendung der Google Play Developer API erforderlich sind.
- Erstellen Sie ein Google Cloud-Projekt.
- Aktiviere die Google Play Developer API für dein Google Cloud-Projekt.
- Richten Sie ein Dienstkonto mit den entsprechenden Google Play Console-Berechtigungen ein, um auf die Google Play Developer API zuzugreifen.
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 empfiehlt es sich, ein Dienstkonto für den Zugriff auf die API zu 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 an Dritte weitergegeben werden, 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 deine Website beispielsweise im Namen des Nutzers über den Webclient auf die Google Play Developer API zugreifen muss, kannst du 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 durchführen, ohne die Anmeldedaten des Dienstkontos zu beeinträchtigen.
- 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 über die 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 im Feld für die E-Mail-Adresse eine E-Mail-Adresse für Ihr Dienstkonto 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.
Jetzt 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
Sie können Nutzern erlauben, mithilfe eines OAuth mit ihren eigenen Anmeldedaten Aktionen in der API auszuführen. Nutzer können nur Aktionen ausführen, die in der Google Play Console auf der Seite Nutzer und Berechtigungen zulässig sind.
Bevor Sie OAuth-Clients erstellen, 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:
- Rufen Sie in der Google Cloud Console Anmeldedaten auf.
- Klicke auf Anmeldedaten erstellen > OAuth-Client-ID.
- Wählen Sie Ihren Anwendungstyp aus und folgen Sie der Anleitung.
Weitere Informationen
Die folgenden Tipps und Tricks erleichtern Ihnen den Einstieg in die API-Nutzung bei Google Play.
Entwickler-ID abrufen
Für einige APIs ist die Angabe einer Google Play Console-Entwickler-ID erforderlich. Dies ist eine lange Nummer, die bei der Erstellung Ihres Google Play-Entwicklerkontos zugewiesen wurde. Sie finden Ihre Entwickler-ID in der URL fast jeder Seite in der Google Play Console, z. B. auf der Seite API-Zugriff.
Sehen wir uns zum Beispiel die URL der Google Play Console an:
https://play.google.com/console/developers/1234567890123456789/api-access
In der URL oben lautet 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 Abschluss der Übertragung die Entwickler-ID des neuen Google Play-Entwicklerkontos in API-Aufrufen für diese App verwenden müssen.
Spezialisierte APIs
Die Google Play Developer API enthält mehrere spezialisierte APIs, mit denen Sie bestimmte Arten von Analysen Ihrer App durchführen können:
- Reply to Reviews API
- Ermöglicht es dir, Nutzerfeedback zu deiner App anzusehen und auf dieses Feedback zu antworten.
- Voided Purchases API
- Ermöglicht dir, den Zugriff auf In-App-Produkte in Verbindung mit Käufen zu widerrufen, die ein Nutzer storniert hat.
Clientbibliotheken
Wir stellen Ihnen Clientbibliotheken zur Verfügung, mit denen Sie programmatisch auf die REST APIs zugreifen können. Weitere Informationen finden Sie unter Clientbibliotheken und Codebeispiele.