Google Play-Spieldienste einrichten

In diesem Dokument wird beschrieben, wie du die Google Play Console zum Einrichten von Google Play-Spieldiensten für dein Android-Spiel verwendest. Die Google Play Console bietet einen zentralen Ort, an dem du Spieldienste verwalten und Metadaten für die Autorisierung und Authentifizierung deines Spiels konfigurieren kannst.

So fügen Sie Ihr Spiel zur Google Play Console hinzu:

• Erstellen Sie ein Spielprojekt für Ihr Spiel und geben Sie Details wie den Namen und die Beschreibung des Spiels an.
• Erstellen und verknüpfen Sie die erforderlichen Anmeldedaten, um Ihr Spiel bei den Google Play-Spieldiensten zu autorisieren und zu authentifizieren.

Diese Schritte werden in den folgenden Abschnitten ausführlicher behandelt.

Schritt 1: In der Google Play Console anmelden

Rufe die Google Play Console auf, um dich anzumelden. Wenn Sie sich noch nicht für die Google Play Console registriert haben, werden Sie dazu aufgefordert.

Schritt 2: Spiel zur Google Play Console hinzufügen

So fügen Sie Ihr Spiel hinzu:

1. Erstellen Sie ein Spiel in der Play Console, falls Sie das noch nicht getan haben. Weitere Informationen
2. Rufen Sie Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Konfiguration auf.

3. Gib an, ob für dein Spiel bereits Google APIs wie Firebase verwendet werden. Die Auswahl der richtigen Option ist sehr wichtig.

   • Wenn Sie dieses Spiel von Grund auf neu erstellen oder noch nie Google APIs dafür eingerichtet haben, wählen Sie Nein, mein Spiel verwendet keine Google APIs aus. Geben Sie den Namen des Spiels ein und klicken Sie auf Erstellen.
   • Wenn es sich um ein Spiel handelt, für das Sie bereits eine oder mehrere Google APIs eingerichtet haben, wählen Sie Ja, mein Spiel verwendet bereits Google APIs aus. Sie sehen eine Liste mit Projekten aus der Google Cloud Console, für die Sie als Entwickler aufgeführt sind. Wählen Sie Ihr Projekt aus der Liste aus und klicken Sie auf Verwenden.
   • Wenn Sie ein vorhandenes Play-Spieldienste-Projekt verwenden möchten, wählen Sie Vorhandenes Play-Spieldienste-Projekt verwenden aus. Sie sehen eine Liste der vorhandenen Play-Spieldienste-Projekte für Ihr Konto. Wählen Sie das richtige Spielprojekt aus der Liste aus und klicken Sie auf Verwenden. Dies ist keine typische Wahl, aber Sie können das tun, wenn Sie ein neues Spiel in der Play Console erstellen, um den Paketnamen zu ändern, oder wenn Sie kostenlose und kostenpflichtige Versionen Ihres Spiels mit verschiedenen Paketnamen haben.

4. In der Google Cloud Console wird ein Spielprojekt für die Play-Spieldienste erstellt und ein entsprechender Eintrag erstellt.

5. Im Abschnitt Eigenschaften können Sie Eigenschaften bearbeiten auswählen und dann die Beschreibung, die Kategorie und die Grafikinhalte für das Spiel hinzufügen.

   • Für Testzwecke ist nur der Anzeigename erforderlich. Die anderen Felder müssen ausgefüllt sein, bevor Sie Ihr Spiel veröffentlichen können.
   • Der Anzeigename und die Beschreibung deines Spiels sollten mit den Angaben übereinstimmen, die du für den Play Store-Eintrag deines Spiels festgelegt hast.
   • Richtlinien zum Erstellen von Grafikinhalten findest du im Google Play-Entwicklerleitfaden und in den Google Play-Richtlinien für Bilder.

Schritt 3: OAuth 2.0-Client-ID generieren

Ihr Spiel muss eine OAuth 2.0-Client-ID haben, um authentifiziert und autorisiert zu werden, um die Google Play-Spieldienste aufzurufen. Wenn Sie die Anmeldedaten für die Play-Spieldienste einrichten möchten, bei denen es sich um die Verknüpfung zwischen einer Client-ID und Ihrem Spiel handelt, verwenden Sie die Google Cloud Platform, um die Client-ID zu erstellen. Verwende dann die Google Play Console, um Anmeldedaten hinzuzufügen und die Client-ID mit deinem Spiel zu verknüpfen.

Eine ausführliche Anleitung finden Sie hier:

a. OAuth-Zustimmungsbildschirm konfigurieren

Wenn Sie den OAuth-Zustimmungsbildschirm noch nicht konfiguriert haben, wird im Abschnitt Anmeldedaten eine Meldung angezeigt, in der Sie zur Konfiguration aufgefordert werden.

Klicken Sie auf Konfigurieren. Ein Dialogfeld mit weiteren Anleitungen und einem Deeplink zur Google Cloud Platform wird geöffnet.

Hinweis: Achten Sie darauf, dass der Zustimmungsbildschirm für alle Nutzer des Spiels verfügbar ist. Die endgültige Liste der Bereiche muss games, games_lite und drive.appdata enthalten. Für keinen dieser Bereiche ist eine Anwendungsbestätigung erforderlich. Wir empfehlen, den Zustimmungsbildschirm sofort zu veröffentlichen. Wenn dies nicht möglich ist, können Sie den Zustimmungsbildschirm für Tester verfügbar machen, damit sie sich im Spiel anmelden können.

Wenn Sie die Einrichtung des OAuth-Zustimmungsbildschirms abgeschlossen haben, klicken Sie auf Fertig. Die Google Play Console wird automatisch aktualisiert. Wenn die Konfiguration erfolgreich war, können Sie Anmeldedaten erstellen:

b. Anmeldedaten erstellen

Damit Ihr Spiel mit den Google Play-Spieldiensten kommunizieren kann, müssen Sie Anmeldedaten mit einer autorisierten OAuth2-Client-ID erstellen.

Klicken Sie im Bereich Anmeldedaten auf Anmeldedaten hinzufügen.

Wählen Sie im Assistenten aus, ob Sie Android-Anmeldedaten erstellen möchten, wenn Ihr Spiele-APK den Nutzer authentifizieren und die PGS APIs verwenden soll, oder einen Spielserver, falls Ihr Spieleserver PGS APIs verwendet. Folgen Sie der Anleitung für Ihren gewünschten Anmeldedatentyp.

Android

Details zu Anmeldedaten einrichten

Der Name im Feld Name muss mit dem Namen des Spiels übereinstimmen. Wählen Sie aus, ob Sie Anti-Piraterie-Maßnahmen aktivieren möchten.

Autorisierung einrichten

Wähle als Nächstes eine OAuth-Client-ID für dieses Spielprojekt aus. Wenn Sie bereits OAuth2-Client-IDs haben, können Sie eine auswählen. Normalerweise erstellen Sie jedoch ein neues. Klicken Sie auf OAuth-Client erstellen. Daraufhin wird ein Dialogfeld mit Deeplinks und einer Anleitung zum Erstellen einer OAuth-Client-ID in der Google Cloud Platform geöffnet.

1. Wählen Sie als Anwendungstyp Android aus.
2. Geben Sie in das Feld Name den Namen Ihres Spiels ein.
3. Geben Sie den Paketnamen Ihrer Android-App in das Feld Paketname ein.

4. Öffnen Sie ein Terminal und führen Sie das Keytool-Dienstprogramm aus, um die SHA1-Fingerabdrücke der Release- und Debug-Zertifikate abzurufen.

   Führen Sie den folgenden Befehl aus, um den Fingerabdruck des Releasezertifikats abzurufen:

   keytool -list -keystore <path-to-production-keystore> -v

   Führen Sie den folgenden Befehl aus, um den Fingerabdruck des Debugzertifikats abzurufen:

   keytool -list -keystore <path-to-debug-keystore> -v

   Hinweis: Unter Windows befindet sich der Schlüsselspeicher für die Fehlerbehebung unter C:\Users\<USERNAME>\.android\debug.keystore. Unter Mac oder Linux befindet sich der Keystore für die Fehlerbehebung normalerweise unter ~/.android/debug.keystore.

5. Das Keytool-Dienstprogramm fordert Sie auf, ein Passwort für den Schlüsselspeicher einzugeben. Das Standardpasswort für den Schlüsselspeicher für die Fehlerbehebung ist android. Das Keytool druckt dann den Fingerabdruck auf dem Terminal.

6. Fügen Sie den SHA1-Fingerabdruck in das Feld Signaturzertifikat-Fingerabdruck (SHA1) ein.

7. Klicken Sie auf Erstellen.

Weitere Informationen zu OAuth 2.0 unter Android finden Sie unter Bei OAuth2-Diensten authentifizieren.

Warnung: Notieren Sie sich den Namen und das Signaturzertifikat, das Sie in diesem Schritt konfiguriert haben. Die Verwendung eines anderen Zertifikats oder Paketnamens in Ihrer Anwendung führt zu Authentifizierungsfehlern.

Nachdem Sie im Dialogfeld auf Fertig geklickt haben, werden die verfügbaren Client-IDs aktualisiert. Wählen Sie im Drop-down-Menü die von Ihnen erstellten Anmeldedaten aus und klicken Sie auf Änderungen speichern. Dadurch werden die Anmeldedaten als Entwurf erstellt und Sie können sich in Ihrem Spiel bei den Play-Spieldiensten authentifizieren.

Sie können zwei Anmeldedaten erstellen: eine mit dem Fingerabdruck des Releasezertifikats und eine mit dem Fingerabdruck des Debugzertifikats. Achten Sie darauf, für beide denselben Paketnamen zu verwenden. Dadurch können Google Play-Spieldienste Anrufe von Ihren verknüpften APKs erkennen, die mit einem der beiden Zertifikate signiert sind. Weitere Informationen zum Signieren von Zertifikaten für Android findest du unter App signieren.

Spieleserver

Details zu Anmeldedaten einrichten

Der Name im Feld Name muss mit dem Namen des Spiels übereinstimmen.

Autorisierung einrichten

Wähle als Nächstes eine OAuth-Client-ID für dieses Spielprojekt aus. Wenn Sie bereits OAuth2-Client-IDs haben, können Sie eine auswählen. Normalerweise erstellen Sie jedoch ein neues. Klicken Sie auf OAuth-Client erstellen. Daraufhin wird ein Dialogfeld mit Deeplinks und einer Anleitung zum Erstellen einer OAuth-Client-ID in der Google Cloud Platform geöffnet.

1. Wählen Sie als Anwendungstyp Webanwendung aus.
2. Geben Sie in das Feld Name den Namen Ihres Spiels ein.
3. Klicken Sie auf Erstellen.

Weitere Informationen zu OAuth 2.0 unter Android finden Sie unter Bei OAuth2-Diensten authentifizieren.

Nachdem Sie im Dialogfeld auf Fertig geklickt haben, werden die verfügbaren Client-IDs aktualisiert. Wählen Sie im Drop-down-Menü die von Ihnen erstellten Anmeldedaten aus und klicken Sie auf Änderungen speichern. Dadurch werden die Anmeldedaten als Entwurf erstellt und Sie können sich von Ihrem Spieleserver aus bei den Play-Spieldiensten authentifizieren. Weitere Informationen zur Verwendung der Play-Spieldienste mit Ihrem Spieleserver finden Sie unter Serverseitigen Zugriff auf Google Play-Spieldienste aktivieren.

Häufige Probleme bei der Einrichtung vermeiden

Folgen Sie diesen Empfehlungen, wenn Sie Ihr Spiel für die Verwendung der Google Play-Spieldienste einrichten und damit häufige Einrichtungsfehler vermeiden.

1. Spiel mit der Google Play Console einrichten

Wenn du in der Google Cloud Console eine Oauth 2.0-Client-ID für deine App erstellt hast, kennen die Google Play-Spieldienste nicht die Verknüpfung zwischen dem Erfolg und den Bestenlisten des Spiels und der Client-ID. Zum Erstellen dieser Verknüpfung musst du Anmeldedaten mit der Oauth 2.0-Client-ID erstellen, wie unter Anmeldedaten erstellen beschrieben.

2. Die richtige App-ID in Android verwenden

Die Anwendungs-ID ist eine erforderliche Stringressource, auf die Sie in Ihrem Android-Manifest verweisen müssen. Der Anwendungs-ID-String besteht nur aus den Ziffern (in der Regel zwölf oder mehr) am Anfang der Client-ID, die von der Google Play Console bereitgestellt werden. Sie finden die Anwendungs-ID oben auf der Seite Konfiguration und wird unterhalb des Namens Ihres Spiels als Projekt-ID bezeichnet.

3. APK mit dem richtigen Zertifikat signieren

Wenn du deine Android-App mit deinem Spiel in der Google Play Console verknüpfst, musst du genau denselben Paketnamen und Fingerabdruck verwenden, mit dem du deine App veröffentlicht hast. Bei einer Abweichung treten bei Google Play-Spieldiensten Aufrufe auf. Sie sollten zwei Client-IDs erstellen, eine mit dem Fingerabdruck des Releasezertifikats und eine mit dem Fingerabdruck des Debugzertifikats. Verwenden Sie für beide denselben Paketnamen. Weitere Informationen zum Angeben des Signaturzertifikats in der Google Play Console finden Sie unter Anwendungen signieren.

4. Binden Sie das Play Games SDK bei der Entwicklung für Android als Bibliotheksprojekt ein, nicht als eigenständige JAR-Datei.

Achte darauf, dass das Google Play Services SDK auf ein Bibliotheksprojekt in deinem Android-Projekt verweist. Andernfalls kann es zu Fehlern kommen, wenn deine App die Ressourcen der Google Play-Dienste nicht finden kann. Informationen zum Einrichten deines Android-Projekts für die Verwendung von Google Play-Diensten findest du unter Google Play-Dienste einrichten.

5. Während der Entwicklung mit einem Testkonto anmelden

Wenn du deine Spieleinstellungsänderungen nicht in der Google Play Console veröffentlicht hast, können beim Testen Fehler auftreten, wenn du nicht mit einem Testkonto auf der Zulassungsliste angemeldet bist. Du solltest dein Google Play Console-Publisher-Konto immer zu Testzwecken aktivieren. Informationen zum Verwalten von Testkonten finden Sie unter Konten für Tests aktivieren.

6. Zustimmungsbildschirm in der Google Cloud Platform veröffentlichen

Bevor du die App in der Google Play Console veröffentlichst, musst du den Zustimmungsbildschirm auf der Google Cloud Platform veröffentlichen. Ohne diesen Schritt kann die öffentliche Zielgruppe die Play-Spieldienste-Funktionen nicht verwenden.

7. Veröffentliche zuerst die Einstellungen der Play-Spieldienste, bevor du dein Spiel veröffentlichst

Entwickler können ihre App versehentlich veröffentlichen, ohne die entsprechenden Einstellungen für die Google Play-Spieldienste für ihre App zu veröffentlichen. Dies kann dazu führen, dass bei Spielern, die sich mit Nicht-Testerkonten anmelden, Fehler auftreten, da die App nicht auf die richtigen Spieleinstellungen verweisen kann. Wenn du dein Spiel veröffentlichst, musst du zuerst die Spieleinstellungen mit der Option Spiel veröffentlichen in der Google Play Console veröffentlichen. Informationen zum Veröffentlichen deiner Änderungen findest du unter Spieländerungen veröffentlichen.

Weitere Tipps finden Sie hier:

• Anleitung zur Fehlerbehebung bei Android-Geräten: Entwicklerdokumentation zur Problembehebung bei der Entwicklung von Android-Spielen

Nächste Schritte

Bevor Sie fortfahren, sollten Sie Ihrem Spiel Testkonten hinzufügen, wie unter Konten zum Testen aktivieren beschrieben. Nutzer mit autorisierten Testkonten haben Zugriff auf Ihr unveröffentlichtes Play-Spieldienste-Projekt und können testen, ob Ihre konfigurierten Google Play-Spieldienste richtig funktionieren.

Nachdem Sie die oben beschriebenen Ersteinrichtungsaufgaben abgeschlossen haben, können Sie Funktionen für Ihr Spiel konfigurieren, z. B. Bestenlisten und Erfolge. Weitere Informationen finden Sie unter Funktionen aktivieren.