Einstellungen für Play Games-Dienste-Projekte in Google Cloud verwalten

Es kann vorkommen, dass Sie Ihr Play Games-Dienste-Projekt direkt in Google Cloud aufrufen und bearbeiten möchten.

Es könnte beispielsweise sein, dass Sie:

• zusätzliche APIs wie Google Drive für Ihr Projekt aktivieren,
• Branding-Informationen für Ihr Spiel im OAuth-2.0-Dialog bearbeiten,
• sich Ihr API-Kontingent ansehen und, falls nötig, mehr anfragen und
• autorisierte URIs oder JavaScript-Ursprünge in Client-IDs bearbeiten möchten, die Sie zuvor erstellt haben.

Projekt ansehen

So rufen Sie Ihr Projekt in Google Cloud auf:

1. Wählen Sie auf der Seite Konfiguration Anmeldedaten für Ihr Spiel aus (Nutzer gewinnen > Play Games-Dienste > Einrichtung und Verwaltung > Konfiguration).
2. Rufen Sie den Bereich Authentifizierung auf und klicken Sie auf In Google Cloud ansehen.

Kontingente für die API-Nutzung anpassen

In Google Cloud können Sie die für Ihr Spiel festgelegten Limits für die API-Nutzung und die bereits genutzte Kontingentmenge einsehen. Sie können auch Limits pro Nutzer festlegen, um zu verhindern, dass sich ein unangemessen verhaltender Nutzer (oder ein fehlerhafter Spielclient) Ihr Kontingent aufbraucht.

So rufen Sie die Nutzungslimits für Ihr Projekt auf oder ändern sie oder fordern eine Erhöhung Ihres Kontingents an:

1. Wenn Sie für Ihr Projekt noch kein Rechnungskonto haben, erstellen Sie dieses.
2. Rufen Sie in der API Console die Seite „Aktivierte APIs“ in der API-Bibliothek auf und wählen Sie eine API aus der Liste aus.
3. Klicken Sie auf Kontingente, um die Einstellungen zum Kontingent aufzurufen und zu ändern. Klicken Sie auf Nutzung, um die Nutzungsstatistik einzusehen.

Nutzer werden anhand der IP-Adresse des Clients ermittelt, der die Kontingentanfrage stellt. Wenn beispielsweise alle Ihre Anfragen von einem einzelnen Server stammen, wird dieser Server möglicherweise fälschlicherweise als einzelner Spam-Nutzer gekennzeichnet. Um dies zu verhindern, können Sie Ihren API-Endpunktanfragen ein userIp=x.x.x.x-Argument anhängen.

Weitere Informationen zum Festlegen von Kontingenten pro Nutzer finden Sie unter API-Nutzung deckeln.

Neben einem Limit pro Nutzer gibt es auch ein anwendungsweites Tageslimit für die Google Play Games-Dienste API. In der Regel müssen Sie das vorab zugewiesene Limit nicht ändern. Wenn Sie jedoch mit einem starken Anstieg des Traffics rechnen (z. B. bei einer bevorstehenden Produkteinführung), können Sie zusätzliches Kontingent anfordern. Klicken Sie dazu auf den Link Mehr anfordern.

Andere APIs aktivieren

Wenn Sie Ihre Client-ID in der Play Console erstellen, wird die Google Play Games-Dienste API automatisch für Ihr Projekt aktiviert. Sie können andere Google APIs über Google Cloud aktivieren.

So aktivieren Sie eine API für Ihr Projekt:

1. Öffnen Sie die API-Bibliothek in der Google API Console. Wählen Sie bei Aufforderung ein Projekt aus oder erstellen Sie ein neues. In der API-Bibliothek finden Sie alle verfügbaren APIs nach Produktfamilie und Beliebtheit gruppiert.

2. Wenn die API, die Sie aktivieren möchten, nicht in der Liste angezeigt wird, suchen Sie danach.

3. Wählen Sie die API aus, die Sie aktivieren möchten, und klicken Sie dann auf die Schaltfläche Aktivieren.

4. Aktivieren Sie bei Aufforderung die Abrechnung.

5. Akzeptieren Sie bei Aufforderung die Nutzungsbedingungen der API.

Branding-Informationen ändern

Wenn Sie die Branding-Informationen (Titel, Logo usw.) für Ihr Spiel ändern möchten, die im OAuth 2.0-Dialog angezeigt werden, legen Sie die Attribute im Zustimmungsbildschirm von Google Cloud fest.

So richten Sie den Zustimmungsbildschirm Ihres Projekts ein:

1. Öffnen Sie in der Play Console die Seite „Zustimmungsbildschirm“ . Wählen Sie bei Aufforderung ein Projekt aus oder erstellen Sie ein neues.
2. Füllen Sie das Formular aus und klicken Sie auf Speichern.

OAuth-Nutzertyp ändern

Wenn Sie im Produktion (Test und Release > Produktion) Testtrack mit einem privaten Testkonto testen, müssen Sie die Einstellung für die OAuth-Zielgruppe in Google Cloud auch auf Extern konfiguriert haben. Weitere Informationen finden Sie unter Zielgruppe der App verwalten.

Attribute im Zusammenhang mit der Client-ID ändern

So ändern Sie Attribute im Zusammenhang mit Ihrer OAuth 2.0-Client-ID (Webursprünge und Weiterleitungs-URLs für eine Webanwendung usw.):

1. Öffnen Sie die Play Console und rufen Sie Ihr Spiel auf.
2. Wählen Sie auf der Seite Konfiguration Anmeldedaten für Ihr Spiel aus (Nutzer gewinnen > Play Games-Dienste > Einrichtung und Verwaltung > Konfiguration).
3. Scrollen Sie zum Ende des Bereichs Authentifizierung und klicken Sie auf In Google Cloud ansehen.
4. Wählen Sie in Google Cloud Ihr Projekt aus.
5. Wählen Sie in der linken Seitenleiste APIs und Authentifizierung aus. Prüfen Sie, ob der Status der Google Play Games-Dienste API in der angezeigten Liste der APIs auf AN gesetzt ist.
6. Wählen Sie in der linken Seitenleiste Registrierte Apps aus.
7. Maximieren Sie den Bereich „OAuth 2.0-Client-ID“ und suchen Sie das Attribut, das Sie bearbeiten möchten.

OAuth-Clients aus einem vorhandenen Cloud-Projekt migrieren

Folgen Sie der Anleitung unter Projekt ansehen, um Ihr Projekt in Google Cloud aufzurufen.

Für die Einrichtung der Play Games-Dienste (PGS) ist ein eindeutiges Google Cloud-Projekt erforderlich. Wenn mehrere Spiele ein Cloud-Projekt gemeinsam nutzen, müssen Sie die Android-OAuth-Clients zu unabhängigen Projekten migrieren, um eine ordnungsgemäße Konfiguration zu gewährleisten.

Im obigen Beispiel haben Spiel 1 und Spiel 2 ihre Web- und Android-Clients in einem einzigen Google Cloud-Projekt für „Mit Google anmelden“ erstellt. Wir müssen die Web- und Android-Clients von Spiel 2 aus dem aktuellen alten Google Cloud-Projekt in ein neues Ziel -Google Cloud-Projekt verschieben.

Schritt 1: Backend-Vorbereitung

Bevor Sie die Umstellung vornehmen, müssen Sie Ihr Backend und Ihre Clients so anpassen, dass sie mit dem gleichzeitigen Vorhandensein von alten und neuen Webclient-IDs umgehen können.

• Serverseitige Konfiguration: Wenn Ihr Server die Webclient-ID im ID-Token validiert, müssen Sie Ihre serverseitige Logik so aktualisieren, dass sie gleichzeitig ID-Tokens unterstützt, die sowohl von den alten Clients im alten Cloud-Projekt als auch von den neuen Clients ausgestellt werden, die Sie im Ziel-Cloud-Projekt generieren müssen.
• Clientseitige Konfiguration: Ihre Clientanwendung muss mehrere Webclient-IDs unterstützen, damit sie sich bei der Umstellung mit der neuen Webclient-ID anmelden kann. Sie können eine der folgenden Methoden verwenden:
  • Zwei Webclient-IDs in die Client-App einbauen und zur neuen Webclient-ID wechseln, wenn die alte Client-ID abläuft
  • Die neueste Webclient-ID dynamisch vom Server abrufen, um die Umstellung abzuschließen
• Webclients vorab erstellen: In Ihrem Zielprojekt müssen Sie im Voraus einen neuen Webclient erstellen, um potenzielle Verzögerungen während der atomaren Umstellung zu vermeiden.

Schritt 2: Neue Web- und Android-OAuth-Clients in der richtigen Google Cloud konfigurieren

Schritt 2.1: Erstellen Sie einen neuen Web-OAuth-Client für Spiel 2 im Ziel -Google Cloud-Projekt:

Schritt 2.2: Warnung: Wenn Sie den Android-Client ändern, können sich die Nutzer Ihres Spiels nicht mehr mit „Mit Google anmelden“ in Ihrem Spiel anmelden. Sie müssen Schritt 2.3 daher sofort nach Schritt 2.2 ausführen. Es empfiehlt sich, zwei Webseiten gleichzeitig zu öffnen, um den Zeitraum zwischen Änderung und Neuerstellung zu minimieren.

Ändern Sie den Paketnamen des Android-Clients von Spiel 2 im alten Google Cloud-Projekt in einen ungültigen Wert, z. B. com.noexist.none.

Schritt 2.3: Erstellen Sie sofort einen neuen Android-Client für Spiel 2 mit dem gleichen SHA-1-Fingerabdruck und Paketnamen von Spiel 2 im Ziel -Google Cloud-Projekt:

Schritt 3: Konfigurationsbereitstellung in Echtzeit

Nachdem Sie den neuen Android-Client im Ziel -Projekt erstellt haben, führen Sie sofort die folgenden Schritte aus:

• Clients umleiten: Verwenden Sie Ihren dynamischen Konfigurationsmechanismus (z. B. Remote Config), um die Clientanwendung sofort so umzustellen, dass sie die neue Webclient-ID verwendet.
• Alte Clients behalten: Behalten Sie die alten OAuth-Clients als Fallback-Option bei, um bei Problemen ein Rollback zur vorherigen OAuth-Client-Anmeldung durchzuführen.