Diese Seite wurde von der Cloud Translation API übersetzt.

Google Play-Spieldienste einrichten

Auf dieser Seite wird beschrieben, wie Sie Google Play-Spieldienste für Ihr Android-Spiel mit der Google Play Console einrichten. In der Play Console können Sie Spieldienste zentral verwalten und die Metadaten konfigurieren, die zur Autorisierung und Authentifizierung Ihres Spiels verwendet werden.

So fügen Sie Ihr Spiel der 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 für die Google Play-Spieldienste zu autorisieren und zu authentifizieren.

Vorbereitung

Führen Sie die folgenden Schritte aus, bevor Sie die Google Play-Spieldienste konfigurieren.

Google Play-Entwicklerkonto erstellen

Sie müssen in der Play Console ein Google Play-Entwicklerkonto eingerichtet haben. Weitere Informationen finden Sie unter Für ein Google Play-Entwicklerkonto registrieren.
Berechtigung zum Bearbeiten gewähren: Damit Ihr Team die Einstellungen der Play-Spieldienste in der Play Console bearbeiten kann, muss es Berechtigungen zum Verwalten der Play-Spieldienste haben. Weitere Informationen finden Sie unter Nutzer von Entwicklerkonten hinzufügen und Berechtigungen verwalten.

Google Cloud-Projekt erstellen

Sie müssen ein Google Cloud-Projekt eingerichtet haben. Weitere Informationen finden Sie unter

Wenn Sie die Play Console verwenden möchten, müssen Sie die APIs aktivieren, die Sie in Ihrem Projekt verwenden möchten.

Console

Google Play Game Services API aktivieren

gcloud

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

In der Play Console anmelden

Melden Sie sich in der Google Play Console an. 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:

Erstellen Sie in der Play Console eine App und geben Sie an, dass es sich um ein Spiel handelt. Weitere Informationen finden Sie unter App erstellen und einrichten.
Gehen Sie zu Wachstum > Play-Spieldienste > Einrichtung und Verwaltung > Konfiguration.
Geben Sie an, ob in Ihrem Spiel bereits Google APIs (z. B. Firebase) verwendet werden. Es ist wichtig, dass Sie die richtige Option auswählen. Andernfalls kann es bei der Verwendung von Google APIs zu Problemen mit Ihrem Spiel kommen. Folgende Optionen sind verfügbar:
- Nein, in meinem Spiel kommen keine Google-APIs zum Einsatz: 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 auf Erstellen.
- Ja, in meinem Spiel kommen bereits Google-APIs zum Einsatz: Wählen Sie diese Option aus, wenn Sie bereits eine Google API für das Spiel eingerichtet haben. 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 auf Verwenden.
- Vorhandenes Play-Spieldienste-Projekt verwenden: Wenn Sie ein vorhandenes Play-Spieldienste-Projekt verwenden möchten, wählen Sie diese Option aus. Daraufhin wird eine Liste der vorhandenen Play-Spieldienste-Projekte für Ihr Konto angezeigt. Wählen Sie in der Liste Ihr Spielprojekt aus und klicken Sie auf Verwenden. Diese Option wird nicht häufig verwendet. Sie kann jedoch sinnvoll sein, wenn Sie ein neues Spiel in der Play Console erstellen, um den Paketnamen zu ändern, oder wenn Sie eine kostenlose und eine kostenpflichtige Version Ihres Spiels mit unterschiedlichen Paketnamen haben.
Es wird ein Play-Spieldienste-Spielprojekt erstellt und ein entsprechender Eintrag in der Google Cloud Console.
Klicken Sie im Bereich Properties (Properties bearbeiten) auf Edit Properties (Properties bearbeiten), um Informationen wie die Beschreibung, die Kategorie und die Grafik-Assets für Ihr Spiel hinzuzufügen. Hier sind einige Richtlinien für die Konfiguration der Properties:
- Für Testzwecke ist nur der angezeigte Name erforderlich. Die anderen Felder müssen ausgefüllt sein, bevor Sie Ihr Spiel veröffentlichen können.
- Der Anzeigename und die Beschreibung Ihres Spiels müssen mit den Angaben im Play Store-Eintrag Ihres Spiels übereinstimmen.
- Richtlinien zum Erstellen von Grafik-Assets finden Sie unter Vorschauelemente hinzufügen und in den Google Play-Richtlinien für vorgestellte Bilder.

OAuth-2.0-Client-ID erstellen

Ihr Spiel muss eine OAuth 2.0-Client-ID haben, um authentifiziert und autorisiert zu werden, die Google Play-Spieldienste aufzurufen. Wenn Sie Anmeldedaten für Play Spieledienste einrichten möchten, also die Verknüpfung zwischen einer Client-ID und Ihrem Spiel, erstellen Sie die Client-ID mit der Google Cloud Platform. Fügen Sie dann in der Google Play Console Anmeldedaten hinzu und verknüpfen Sie die Client-ID mit Ihrem Spiel.

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

OAuth-Zustimmungsbildschirm konfigurieren

Wenn Sie den OAuth-Zustimmungsbildschirm noch nicht konfiguriert haben, wird im Bereich Anmeldedaten eine entsprechende Aufforderung angezeigt.

Aufforderung zum Konfigurieren des OAuth-Zustimmungsbildschirms

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

Sie werden aufgefordert, den OAuth-Zustimmungsbildschirm zu konfigurieren.

Der Einwilligungsbildschirm muss für alle Nutzer verfügbar sein, 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 App-Bestätigung erforderlich. Wir empfehlen, den Einwilligungsbildschirm sofort zu veröffentlichen. Wenn das nicht möglich ist, können Sie den Einwilligungsbildschirm 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 ein Anmeldedaten erstellen:

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 Abschnitt Anmeldedaten auf Anmeldedaten hinzufügen.

Wählen Sie im Assistenten aus, ob Sie Android-Anmeldedaten erstellen möchten (wenn Ihr Spiel-APK den Nutzer authentifizieren und die Play-Spieldienste-APIs verwenden soll) oder Game-Server-Anmeldedaten (wenn Ihr Game-Server die Play-Spieldienste-APIs verwenden soll). Folgen Sie der Anleitung für den gewünschten Anmeldedatentyp.

Android

Anmeldedaten einrichten

Der Name im Feld Name muss mit dem Namen Ihres Spiels übereinstimmen. Wähle aus, ob du Anti-Piraterie-Maßnahmen aktivieren möchtest.

Autorisierung einrichten

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

Wählen Sie als Anwendungstyp Android aus.
Geben Sie in das Feld Name den Namen Ihres Spiels ein.
Geben Sie im Feld Paketname den Paketnamen Ihrer Android-Anwendung ein.
Öffnen Sie ein Terminal und führen Sie das Keytool-Dienstprogramm aus, um die SHA1-Fingerabdrücke der Release- und Debug-Zertifikate zu erhalten.

Führen Sie den folgenden Befehl aus, um den Fingerabdruck des Release-Zertifikats 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 Schlüsselspeicher für die Fehlerbehebung normalerweise unter ~/.android/debug.keystore.
Optional: Wenn Sie mit Unity Hub einen neuen Schlüsselspeicher erstellt haben, erstellen Sie kein neues Zertifikat anhand der Anleitung im vorherigen Schritt. Verwenden Sie den SHA1-Fingerabdruck, den Sie in Unity erstellt haben.
- Verwenden Sie den folgenden Befehl, um den SHA1-Fingerabdruck im Terminal zu drucken:
  
  keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v
Sie werden vom Dienstprogramm „keytool“ aufgefordert, ein Passwort für den Schlüsselspeicher einzugeben. Das Keytool gibt den Fingerabdruck dann im Terminal aus.
Fügen Sie den SHA1-Fingerabdruck in das Feld Signaturzertifikat-Fingerabdruck (SHA1) ein.
Klicken Sie auf Erstellen.

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

Sie können zwei Anmeldedaten erstellen: eine mit dem Fingerabdruck des Freigabezertifikats und eine mit dem Fingerabdruck des Debugzertifikats. Verwenden Sie für beide denselben Paketnamen. So können die Google Play-Spieldienste Aufrufe von Ihren verknüpften APKs erkennen, die mit einem der beiden Zertifikate signiert sind. Weitere Informationen zur Zertifikatsignatur für Android finden Sie unter App signieren.

Spieleserver

Anmeldedaten einrichten

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

Autorisierung einrichten

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

Weitere Informationen zu OAuth 2.0 auf Android finden Sie unter OAuth2-Dienste authentifizieren.

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

Tests aktivieren

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

Wenn Ihr Spiel noch nicht veröffentlicht wurde, gewähren Sie Ihren Testern Zugriff, indem Sie ihre Nutzerkonten der Zulassungsliste hinzufügen. Andernfalls erhalten Ihre Tester OAuth- und 404-Fehler, wenn sie versuchen, auf Endpunkte der Play-Spieldienste zuzugreifen, z. B. den Endpunkt für die Anmeldung.

Nutzer mit autorisierten Testkonten haben Zugriff auf Ihr unveröffentlichtes Play-Spieldienste-Spielprojekt und können testen, ob Ihre konfigurierten Play-Spieldienste ordnungsgemäß funktionieren.

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

Auf individueller Ebene, indem Sie einzelne E-Mail-Adressen hinzufügen.
Auf Gruppenebene, indem Sie die Play-Spieldienste für einen Play Console-Release-Track aktivieren.

So fügen Sie Ihrem Spielprojekt einzelne Tester hinzu:

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

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

Mit den Release-Track-Funktionen von Google Play können Sie Vorabversionen Ihrer App ganz einfach an kontrollierte Gruppen von vertrauenswürdigen Nutzern verteilen. Weitere Informationen finden Sie auf der Google Play-Hilfeseite unter Offenen, geschlossenen oder internen Test einrichten.

Sie können allen Nutzern, die Zugriff auf APKs für einen bestimmten Release-Track haben, Zugriff zum Testen Ihres Spiels gewähren. Das funktioniert genauso, als hätten Sie sie einzeln der Testerliste hinzugefügt. Gehen Sie hierzu folgendermaßen vor:

Ö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 finden Sie auch eine Liste der Tracks, die bereits für Tests der Play-Spieldienste aktiviert sind.
Klicken Sie auf Tracks hinzufügen.
Wählen Sie einen oder mehrere Tracks aus, die für Play-Spieldienste-Tests aktiviert werden sollen.
Klicken Sie auf Tracks hinzufügen.

Die ausgewählten Release-Tracks werden jetzt in der Liste der Tracks angezeigt, die für Tests mit Play-Spieldiensten aktiviert sind.

Diese Funktion ist nur verfügbar, wenn Sie in der Google Play Console eine Android-App mit Ihrem Spiel verknüpft haben.

Häufige Probleme vermeiden

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

1. Spiel in der Play Console einrichten: Wenn Sie in der Google Cloud Console eine OAuth 2.0-Client-ID für Ihre App erstellt haben, ist Google Play Spiele nicht über die Verknüpfung zwischen den Erfolgen und Bestenlisten des Spiels und der Client-ID informiert. Um diese Verknüpfung zu erstellen, müssen Sie wie unter Anmeldedaten erstellen beschrieben Anmeldedaten mit der OAuth 2.0-Client-ID erstellen.
2. Die richtige Anwendungs-ID in Android verwenden: Die App-ID ist eine erforderliche Stringressource, auf die Sie in Ihrem Android-Manifest verweisen müssen. Der String der Anwendungs-ID besteht nur aus den Ziffern (in der Regel mindestens 12) am Anfang der Client-ID, die in der Play Console angegeben wurde. Die Anwendungs-ID finden Sie oben auf der Seite Konfiguration unter dem Namen Ihres Spiels als Projekt-ID.
3. Signieren Sie Ihr APK mit dem richtigen Zertifikat.: Wenn Sie Ihre Android-App in der Play Console mit Ihrem Spiel verknüpfen, müssen Sie genau denselben Paketnamen und Zertifikatsfingerabdruck verwenden, den Sie auch für die Veröffentlichung Ihrer App verwendet haben. Andernfalls schlagen Aufrufe an die Google Play-Spieldienste fehl. Sie sollten zwei Client-IDs erstellen, eine mit dem Fingerabdruck des Release-Zertifikats und eine mit dem Fingerabdruck des Debug-Zertifikats, und für beide denselben Paketnamen verwenden. Weitere Informationen zum Angeben des Signaturzertifikats in der Play Console finden Sie unter Anwendung signieren.
4. Wenn Sie für Android entwickeln, fügen Sie das Play Games SDK als Bibliotheksprojekt und nicht als eigenständige JAR-Datei hinzu.: Achten Sie darauf, dass das Google Play Services SDK in Ihrem Android-Projekt als Bibliotheksprojekt referenziert wird. Andernfalls kann es zu Fehlern kommen, wenn Ihre App keine Google Play-Dienstressourcen finden kann. Informationen zum Einrichten Ihres Android-Projekts für die Verwendung von Google Play-Diensten finden Sie unter Google Play-Dienste einrichten.
5. Während der Entwicklung mit einem Testerkonto anmelden: Wenn Sie die Änderungen an den Spieleinstellungen nicht in der Play Console veröffentlicht haben, können beim Testen Fehler auftreten, wenn Sie nicht mit einem auf der Zulassungsliste stehenden Testerkonto angemeldet sind. Sie sollten Ihr 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 Sie die App in der Play Console veröffentlichen, müssen Sie den Einwilligungsbildschirm in der Google Cloud Platform veröffentlichen. Ohne diesen Schritt kann die allgemeine Zielgruppe keine der Funktionen der Play-Spieldienste verwenden.
7. Veröffentlichen Sie bei der Veröffentlichung zuerst die Play-Spieldienste-Einstellungen, bevor Sie Ihr Spiel veröffentlichen.: Entwickler können ihre App versehentlich veröffentlichen, ohne die entsprechenden Play-Spieldienste-Einstellungen für ihre App zu veröffentlichen. Dies kann dazu führen, dass Spieler, die sich mit Konten anmelden, die keine Testerkonten sind, Fehler erhalten, da die App nicht auf die richtigen Spieleinstellungen verweisen kann. Denken Sie daran, beim Veröffentlichen Ihres Spiels zuerst die Spieleinstellungen zu veröffentlichen. Verwenden Sie dazu in der Play Console die Option Spiel veröffentlichen. Informationen zum Veröffentlichen Ihrer Änderungen finden Sie unter Spieländerungen veröffentlichen.

Weitere Tipps finden Sie im Leitfaden zur Fehlerbehebung für Android.

Nächste Schritte

Nachdem Sie die oben beschriebenen ersten Einrichtungsaufgaben abgeschlossen haben, können Sie Play Spiele-Dienstfunktionen für Ihr Spiel aktivieren, z. B. gespeicherte Spiele, Bestenlisten und Erfolge.