Google Play-Spieldienste einrichten

Auf dieser Seite wird beschrieben, wie du die Google Play-Spieldienste für dein Android-Spiel mit der Google Play Console einrichtest. Die Play Console bietet einen zentralen Ort, an dem Sie Spieldienste verwalten und die Metadaten für die Autorisierung und Authentifizierung Ihres Spiels konfigurieren können.

So fügen Sie der Play Console Ihr Spiel hinzu:

  • Erstellen Sie ein Spielprojekt für Ihr Spiel und geben Sie Details wie den Namen und die Beschreibung des Spiels an.

  • Erstelle die Anmeldedaten und verknüpfe sie, um dein Spiel bei den Google Play-Spieldiensten zu autorisieren und zu authentifizieren.

Vorbereitung

In der Play Console anmelden

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

Spiel der Play Console hinzufügen

So fügen Sie Ihr Spiel hinzu:

  1. Erstellen Sie in der Play Console eine App und geben Sie an, dass es sich um ein Spiel handelt. Weitere Informationen finden Sie unter Anwendung erstellen und einrichten.

  2. Rufen Sie Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Konfiguration auf.

  3. Gib an, ob in deinem Spiel bereits Google APIs wie Firebase verwendet werden. Es ist wichtig, dass Sie die richtige Option auswählen. Andernfalls können bei der Verwendung von Google APIs Probleme in Ihrem Spiel auftreten. Es gibt folgende Möglichkeiten:

    • Nein, mein Spiel verwendet keine Google-APIs: Wählen Sie diese Option aus, wenn Sie ein neues Spiel erstellen oder noch nie eine Google API dafür eingerichtet haben. Geben Sie den Namen Ihres Spiels ein und klicken Sie dann auf Erstellen.

    • Ja, mein Spiel verwendet bereits Google APIs: Wähle diese Option aus, wenn du bereits eine Google API für das Spiel eingerichtet hast. In diesem Fall wird eine Liste Ihrer Projekte aus der Google Cloud Console angezeigt. Wählen Sie Ihr Projekt aus der Liste aus und klicken Sie dann auf Verwenden.

    • Vorhandenes Play-Spieldienste-Projekt verwenden: Wenn du ein bestehendes Play-Spieldienste-Projekt verwenden möchtest, wähle diese Option aus. Es wird eine Liste der vorhandenen Play-Spieldienste-Projekte für dein Konto angezeigt. Wählen Sie Ihr Spielprojekt aus der Liste aus und klicken Sie dann auf Verwenden. Dies ist keine typische Wahl. Sie können dies jedoch tun, wenn Sie in der Play Console ein neues Spiel erstellen, um den Paketnamen zu ändern, oder wenn Sie kostenlose und kostenpflichtige Versionen Ihres Spiels mit unterschiedlichen Paketnamen haben.

    Ein Play-Spieldienste-Spielprojekt wird erstellt und ein entsprechender Eintrag wird in der Google Cloud Console für dich erstellt.

  4. Klicken Sie im Bereich Eigenschaften auf Eigenschaften bearbeiten, um Informationen wie Beschreibung, Kategorie und Grafikinhalte für Ihr Spiel hinzuzufügen. Hier sind einige Richtlinien für die Coonfiguration der Properties:

OAuth-2.0-Client-ID erstellen

Ihr Spiel muss eine OAuth 2.0-Client-ID haben, um für den Aufruf der Google Play-Spieldienste authentifiziert und autorisiert zu werden. Um Anmeldedaten für die Play-Spieldienste einzurichten, also die Verknüpfung zwischen einer Client-ID und deinem Spiel, verwendest du die Google Cloud Platform, um die Client-ID zu erstellen. Fügen Sie dann über die Google Play Console Anmeldedaten hinzu und verknüpfen Sie die Client-ID mit Ihrem Spiel.

Eine ausführlichere Anleitung finden Sie in den folgenden Schritten:

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

Aufforderung zum Konfigurieren des OAuth-Zustimmungsbildschirms

Klicken Sie auf Configure (Konfigurieren). Daraufhin wird ein Dialogfeld mit weiteren Anweisungen und einem Deeplink zur Google Cloud Platform geöffnet.

Aufforderung zum Konfigurieren des OAuth-Zustimmungsbildschirms.

Achten Sie darauf, dass der Zustimmungsbildschirm für alle Personen verfügbar ist, für die das Spiel verfügbar ist. Die endgültige Liste der Bereiche muss games, games_lite und drive.appdata enthalten. Für keinen dieser Bereiche ist eine Anwendungsüberprüfung erforderlich. Wir empfehlen, den Zustimmungsbildschirm sofort zu veröffentlichen. Wenn das nicht möglich ist, können Sie den Zustimmungsbildschirm den Testern zur Verfügung stellen, 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, kannst du Anmeldedaten erstellen:

Anmeldedaten erstellen

Anmeldedaten erstellen

Um dein Spiel für die Kommunikation mit den Google Play-Spieldiensten zu autorisieren, musst du Anmeldedaten mit einer autorisierten OAuth2-Client-ID erstellen.

Klicken Sie im Bereich Anmeldedaten auf Anmeldedaten hinzufügen.

Wähle im Assistenten aus, ob du Anmeldedaten für Android (wenn dein Spiele-APK den Nutzer authentifiziert und Play-Spieldienste-APIs verwendet) oder Anmeldedaten für Spieleserver (wenn dein Spieleserver Play-Spieldienste-APIs verwendet) erstellen möchtest. Folgen Sie der Anleitung für Ihren gewünschten Anmeldedatentyp.

Android

Details zu Anmeldedaten einrichten

Achten Sie darauf, dass der Name im Feld Name mit dem Namen Ihres Spiels übereinstimmt. Wählen Sie aus, ob Anti-Piraterie aktiviert werden soll.

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. In der Regel erstellen Sie jedoch eine neue. Klicken Sie auf OAuth-Client erstellen. Daraufhin wird ein Dialogfeld mit Deep-Links 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 den Namen des Spiels in das Feld Name 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 Freigabezertifikats abzurufen:

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

    Führen Sie den folgenden Befehl aus, um den Fingerabdruck des Debug-Zertifikats abzurufen:

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

  5. Das Schlüsseltool 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 gibt dann den Fingerabdruck an das Terminal aus.

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

  7. Klicken Sie auf Eintragen.

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 erstellten Anmeldedaten aus und klicken Sie dann auf Änderungen speichern. Dadurch werden die Anmeldedaten als Entwurf erstellt, sodass du dich in deinem Spiel bei den Play-Spieldiensten authentifizieren kannst.

Sie können zwei Anmeldedaten erstellen: eine mit dem Fingerabdruck des Freigabezertifikats und eine mit dem Fingerabdruck des Debug-Zertifikats. Achten Sie darauf, für beide denselben Paketnamen zu verwenden. So können Google Play-Spieldienste Aufrufe von deinen verknüpften APKs erkennen, die mit einem der beiden Zertifikate signiert sind. Weitere Informationen zur Zertifikatssignierung für Android findest du unter App signieren.

Spieleserver

Details zu Anmeldedaten einrichten

Achten Sie darauf, dass der Name im Feld Name mit dem Namen Ihres Spiels übereinstimmt.

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. In der Regel erstellen Sie jedoch eine neue. Klicken Sie auf OAuth-Client erstellen. Daraufhin wird ein Dialogfeld mit Deep-Links 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 den Namen des Spiels in das Feld Name ein.
  3. Klicken Sie auf Eintragen.

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 erstellten Anmeldedaten aus und klicken Sie dann auf Änderungen speichern. Dadurch werden die Anmeldedaten als Entwurf erstellt, sodass du dich von deinem Gameserver bei den Play-Spieldiensten authentifizieren kannst. Weitere Informationen zur Verwendung der Play-Spieldienste mit Ihrem Gameserver finden Sie unter Serverseitigen Zugriff auf Google Play-Spieldienste aktivieren.

Testen aktivieren

Um sicherzustellen, dass die Google Play-Spieldienste in Ihrem Spiel ordnungsgemäß funktionieren, sollten Sie Ihre Spieldienste testen, bevor Sie Ihre Spieländerungen bei Google Play veröffentlichen.

Wenn Ihr Spiel noch nicht veröffentlicht ist, gewähren Sie Ihren Testern Zugriff, indem Sie ihre Nutzerkonten auf die Zulassungsliste setzen. Andernfalls erhalten Ihre Tester OAuth- und 404-Fehler, wenn sie versuchen, auf Play-Spieldienste-Endpunkte wie den Anmeldeendpunkt zuzugreifen.

Nutzer mit autorisierten Testkonten haben Zugriff auf dein unveröffentlichtes Play-Spieldienste-Spielprojekt und können testen, ob die konfigurierten Play-Spieldienste richtig funktionieren.

Es gibt zwei Möglichkeiten, Testern die Verwendung von Play-Spieldienste-APIs für Ihr Spiel zu ermöglichen:

  • Auf individueller Ebene durch Hinzufügen einzelner E-Mail-Adressen

  • Auf Gruppenebene durch Aktivieren der Play-Spieldienste für einen Play Console-Release-Track.

So fügen Sie Ihrem Spielprojekt einzelne Tester hinzu:

  1. Öffnen Sie in der Google Play Console den Tab Tester für Ihr Spiel (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Tester).
  2. Klicken Sie auf die Schaltfläche Tester hinzufügen.
  3. Geben Sie im angezeigten Dialogfeld die E-Mail-Adressen der Google-Konten ein, die Sie als Tester hinzufügen möchten. Trennen Sie die Konten durch Kommas oder eine E-Mail-Adresse pro Zeile.
  4. Klicken Sie auf Hinzufügen, um die Nutzer als Tester zu speichern. Über die von dir hinzugefügten Testerkonten sollte innerhalb weniger Stunden auf die Play-Spieldienste zugegriffen werden können.

Wenn Sie einer Gruppe Testzugriff gewähren möchten, aktivieren Sie einen Release-Track für den Zugriff auf die Play-Spieldienste:

Google Play macht es dir mithilfe der Release-Track-Funktionen leicht, Vorabversionen deiner App an kontrollierte Gruppen vertrauenswürdiger Nutzer zu verteilen. Weitere Informationen finden Sie auf der Google Play-Hilfeseite unter Offenen, geschlossenen oder internen Test einrichten.

Du kannst allen Nutzern, die Zugriff auf Test-APKs in einem bestimmten Release-Track haben, Zugriff zum Testen deines Spiels gewähren. Dies funktioniert so, als hätten Sie sie einzeln zur Testerliste hinzugefügt. Gehen Sie hierzu folgendermaßen vor:

  1. Öffnen Sie den Bereich PGS-Tester (Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Tester) und wählen Sie den Tab Release-Tracks aus. Auf dieser Seite siehst du auch die Liste der Tracks, die bereits für das Testen der Play-Spieldienste aktiviert sind.
  2. Klicken Sie auf Titel hinzufügen.
  3. Wähle einen oder mehrere Tracks aus, die für Tests mit den Play-Spieldiensten aktiviert werden sollen.
  4. Klicken Sie auf Titel hinzufügen.

Die ausgewählten Release-Tracks werden jetzt in der Liste der Tracks angezeigt, die für das Testen der Play-Spieldienste aktiviert sind.

Diese Funktion ist nur verfügbar, wenn du eine Android-App mit deinem Spiel in der Google Play Console verknüpft hast.

Häufige Probleme vermeiden

Folgen Sie diesen Empfehlungen, wenn Sie Ihr Spiel für die Verwendung der Google Play-Spieldienste einrichten, um häufige Fehler bei der Einrichtung zu vermeiden.

1. Spiel mit der Play Console einrichten
Wenn du in der Google Cloud Console eine OAuth 2.0-Client-ID für deine App erstellt hast, wissen die Google Play-Spieldienste nichts über die Verknüpfung zwischen dem Erfolg und den Bestenlisten im Spiel und der Client-ID. Zum Erstellen dieser Verknüpfung müssen Sie mithilfe der OAuth 2.0-Client-ID Anmeldedaten erstellen, wie unter Anmeldedaten erstellen beschrieben.
2. Verwenden Sie die korrekte App-ID in Android.
Die App-ID ist eine erforderliche Stringressource, auf die du in deinem Android-Manifest verweisen musst. Der App-ID-String besteht nur aus den Ziffern (in der Regel 12 oder mehr) am Anfang der Client-ID, die von der Play Console bereitgestellt wird. Die App-ID findest du oben auf der Seite Konfiguration. Sie ist unter dem Namen deines Spiels als Projekt-ID gekennzeichnet.
3. Signieren Sie Ihr APK mit dem richtigen Zertifikat.
Wenn du deine Android-App in der Play Console mit deinem Spiel verknüpfst, musst du exakt denselben Paketnamen und Zertifikat-Fingerabdruck verwenden, den du zum Veröffentlichen deiner App verwendet hast. Im Fall einer Abweichung schlagen Aufrufe an die Google Play-Spieldienste fehl. Erstellen Sie zwei Client-IDs – eine mit dem Fingerabdruck des Freigabezertifikats und eine mit dem Fingerabdruck des Debug-Zertifikats – und verwenden Sie für beide denselben Paketnamen. Weitere Informationen zum Angeben des Signaturzertifikats in der Play Console finden Sie unter Anwendungen signieren.
4. Binde bei der Entwicklung für Android das Play Spiele SDK als Bibliotheksprojekt und nicht als eigenständige JAR-Datei ein.
Achte darauf, dass das Google Play Services SDK in deinem Android-Projekt als Bibliotheksprojekt angegeben ist. Andernfalls kann es zu Fehlern kommen, wenn deine App keine Google Play-Dienste-Ressourcen findet. Informationen zum Einrichten eines Android-Projekts für die Verwendung von Google Play-Diensten findest du unter Google Play-Dienste einrichten.
5. Bei der Entwicklung mit einem Testerkonto anmelden
Wenn du die Änderungen an deinen Spieleinstellungen nicht in der Play Console veröffentlicht hast, können beim Testen Fehler auftreten, wenn du nicht mit einem Testerkonto auf der Zulassungsliste angemeldet bist. Du solltest dein Play Console-Publisher-Konto immer für Tests aktivieren. Informationen zum Verwalten von Testerkonten finden Sie unter Konten für Tests aktivieren.
6. Zustimmungsbildschirm in der Google Cloud Platform veröffentlichen
Bevor du die App in der Play Console veröffentlichst, musst du den Zustimmungsbildschirm auf der Google Cloud Platform veröffentlichen. Ohne diesen Schritt können öffentliche Nutzer keine Funktionen der Play-Spieldienste nutzen.
7. Veröffentliche bei der Veröffentlichung zuerst die Einstellungen der Play-Spieldienste, bevor du dein Spiel veröffentlichst
Es kann vorkommen, dass Entwickler versehentlich ihre App veröffentlichen, ohne die entsprechenden Einstellungen der Play-Spieldienste für ihre App zu veröffentlichen. Dies kann dazu führen, dass bei Spielern, die sich nicht mit einem Testerkonto anmelden, Fehler auftreten, da die App nicht auf die richtigen Spieleinstellungen verweisen kann. Denken Sie bei der Veröffentlichung Ihres Spiels daran, zuerst Ihre Spieleinstellungen zu veröffentlichen. Verwenden Sie dazu die Option Spiel veröffentlichen in der Play Console. Informationen zum Veröffentlichen Ihrer Änderungen finden Sie unter Spieländerungen veröffentlichen.

Weitere Tipps findest du in der Anleitung zur Fehlerbehebung bei Android.

Nächste Schritte

Sobald Sie die oben beschriebenen Schritte zur Ersteinrichtung abgeschlossen haben, können Sie die Play-Spieldienste-Funktionen für Ihr Spiel aktivieren, z. B. gespeicherte Spiele, Bestenlisten und Erfolge.