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

Es kann vorkommen, dass Sie Ihr Play-Spieldienste-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,
• Sie können die Branding-Informationen für Ihr Spiel im OAuth 2.0-Dialogfeld 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.

Dein Projekt ansehen

So rufen Sie Ihr Projekt in Google Cloud auf:

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

API-Nutzungskontingente anpassen

In Google Cloud können Sie die für Ihr Spiel festgelegten API-Nutzungslimits und die Menge des verwendeten Kontingents ansehen. Sie können auch nutzerspezifische Limits festlegen, um zu verhindern, dass ein missbräuchlicher Nutzer (oder ein fehlerhafter Spieleclient) Ihr Kontingent aufbraucht.

Wenn Sie die Nutzungslimits für Ihr Projekt aufrufen oder ändern bzw. eine Erhöhung Ihres Kontingents anfragen möchten, gehen Sie so vor:

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 einzublenden.

„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 Spammer 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.

Zusätzlich zum Limit pro Nutzer gibt es ein anwendungsweites Limit pro Tag für die Google Play Games Services API. In der Regel müssen Sie das vorab zugewiesene Limit nicht ändern. Wenn Sie jedoch mit einem starken Anstieg des Volumens rechnen (z. B. bei einer bevorstehenden Produkteinführung), können Sie über den Link Mehr anfordern zusätzliches Kontingent anfordern.

OAuth-Ratenlimits und Obergrenzen für neue Nutzer ansehen

So rufen Sie Kontingente auf, die sich speziell auf die Raten für die Erteilung der OAuth-Nutzerautorisierung und auf Obergrenzen für neue Nutzer beziehen:

1. Öffnen Sie die Google Cloud Console.
2. Prüfen Sie, ob Sie das richtige Projekt ausgewählt haben.
3. Rufen Sie APIs & Dienste > OAuth-Zustimmungsbildschirm auf.
4. Auf dieser Seite sehen Sie die aktuelle Autorisierungsrate für Nutzer (oder Token-Gewährungsrate) und die Gesamtobergrenze für neue Nutzer.

Wenn Sie sehen, dass Ihr Spiel das Ratenlimit bald erreicht, sollten Sie Maßnahmen ergreifen, um Unterbrechungen für die Spieler zu vermeiden. Beantragen Sie eine Erhöhung des Ratenlimitkontingents.

Weitere Informationen finden Sie unter Ratenbegrenzungen für OAuth-Anwendungen.

Andere APIs aktivieren

Wenn Sie Ihre Client-ID in der Play Console erstellen, wird die Google Play-Spieldienste-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 ein Projekt aus oder erstellen Sie ein neues, wenn Sie dazu aufgefordert werden. 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, können Sie die Suchfunktion verwenden.

3. Wählen Sie die gewünschte API aus und klicken Sie dann auf den Button Aktivieren.

4. Aktivieren Sie die Abrechnung, wenn Sie dazu aufgefordert werden.

5. Akzeptieren Sie die Nutzungsbedingungen der API, wenn Sie dazu aufgefordert werden.

Brandinginformationen ändern

Wenn Sie die Branding-Informationen (Titel, Logo usw.) für Ihr Spiel ändern möchten, die im OAuth 2.0-Dialogfeld 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 ein Projekt aus oder erstellen Sie ein neues, wenn Sie dazu aufgefordert werden.
2. Füllen Sie das Formular aus und klicken Sie auf Speichern.

OAuth-Nutzertyp ändern

Wenn Sie den Produktions-Testlauf (Test und Release > Produktion) mit einem persönlichen Testkonto testen, müssen Sie auch die OAuth-Zielgruppeneinstellung in Google Cloud als Extern konfiguriert haben. Weitere Informationen finden Sie unter Zielgruppe für Apps verwalten.

Attribute im Zusammenhang mit der Client-ID ändern

So ändern Sie Attribute, die mit Ihrer OAuth 2.0-Client-ID zusammenhängen (Webursprünge und Weiterleitungs-URLs für eine Web-App usw.):

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

OAuth-Clients aus einem vorhandenen Cloud-Projekt migrieren

Wenn Sie Ihr Projekt in Google Cloud aufrufen möchten, folgen Sie der Anleitung unter Projekt ansehen.

Für die Einrichtung der Play-Spieldienste ist ein eindeutiges Google Cloud-Projekt erforderlich. Wenn mehrere Spiele ein Cloud-Projekt gemeinsam nutzen, müssen Sie ihre Android-OAuth-Clients zu unabhängigen Projekten migrieren, um eine korrekte Konfiguration zu gewährleisten.

Im vorherigen Beispiel haben Game 1 und Game 2 ihre Web- und Android-Clients in einem einzigen Google Cloud-Projekt für die Anmeldung mit Google erstellt. Wir müssen die Web- und Android-Clients von Spiel 2 vom aktuellen Legacy-Google Cloud-Projekt zu einem neuen Ziel-Google Cloud-Projekt migrieren.

Schritt 1: Backend vorbereiten

Bevor Sie die Umstellung vornehmen, müssen Sie Ihr Backend und Ihre Clients so anpassen, dass sowohl alte als auch neue Web-Client-IDs gleichzeitig verarbeitet werden können.

• Serverseitige Konfiguration: Wenn Ihr Server die Webclient-ID im ID-Token validiert, müssen Sie die serverseitige Logik so aktualisieren, dass ID-Tokens unterstützt werden, die sowohl von den alten Clients im Legacy-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 Web-Client-IDs unterstützen, damit die Anmeldung mit der neuen Web-Client-ID beim Wechsel möglich ist. Sie haben dazu folgende Möglichkeiten:
  • In der Client-App sind zwei Web-Client-IDs integriert. Wenn die alte Client-ID abläuft, wird zur neuen Web-Client-ID gewechselt.
  • Die aktuelle Web-Client-ID dynamisch vom Server abrufen, um den Wechsel abzuschließen
• Webclients im Voraus erstellen: Im Zielprojekt müssen Sie im Voraus einen neuen Webclient erstellen, um potenzielle Verzögerungen während des atomaren Wechsels zu vermeiden.

Schritt 2: Neue OAuth-Clients für Web und Android 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 Nutzer Ihres Spiels nicht mehr mit „Mit Google anmelden“ in Ihrem Spiel anmelden. Sie müssen also Schritt 2.3 unmittelbar nach Schritt 2.2 ausführen. Es wird empfohlen, zwei Webseiten gleichzeitig zu öffnen, um das Zeitintervall 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 SHA-1-Fingerabdruck und dem Paketnamen von Spiel 2 im Ziel-Google Cloud-Projekt:

Schritt 3: Konfigurationsbereitstellung in Echtzeit

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

• Clients weiterleiten: Verwenden Sie Ihren Mechanismus für die dynamische Konfiguration (z. B. Remote Config), um die Clientanwendung sofort so umzustellen, dass sie die neue Web-Client-ID verwendet.
• Alte Clients behalten: Behalten Sie die alten OAuth-Clients als Fallback-Option bei, um bei Problemen zum vorherigen OAuth-Client-Log-in zurückzukehren.