Play Integrity API: Leitfaden zur Verknüpfung von Cloud-Projekten und zu Kontingenten

Die Google Play Integrity API erzwingt ein Limit von 10.000 Anfragen pro Tag für Traffic von Google Cloud-Projekten,die nicht mit einer App in der Google Play Console oder einem SDK in der Play SDK Console verknüpft sind. Dieses Limit ist für die meisten Google Cloud-Projekte bereits aktiv. Für eine kleine Anzahl von Projekten mit bereits erhöhtem Kontingent wurde die Frist bis zum 16. Februar 2027 verlängert, um die Verknüpfung abzuschließen, bevor das Limit erzwungen wird.

In diesem Leitfaden wird erläutert, wie sich die Projektverknüpfung auf Ihr Kontingent auswirkt und wie Sie Ihre Google Cloud-Projekte mit Ihrer App oder Ihrem SDK verknüpfen. Außerdem werden häufig gestellte Fragen beantwortet.

Kurze Zusammenfassung

Wichtiges Detail Beschreibung
Datum der Durchsetzung Für die meisten Projekte bereits aktiv.
16. Februar 2027 für Projekte, für die eine Fristbenachrichtigung gesendet wurde.
Richtlinie Play Integrity API-Anfragen, die von Cloud-Projekten stammen, die nicht mit Ihrer App oder Ihrem SDK verknüpft sind, sind auf 10.000 Anfragen pro Tag begrenzt, unabhängig davon, ob für das Projekt ein höheres benutzerdefiniertes Kontingent konfiguriert ist.
Wer ist betroffen? Apps und SDKs, die mehr als 10.000 Anfragen pro Tag über ein Google Cloud-Projekt stellen, das nicht mit der App (in der Play Console) oder dem SDK (in der Play SDK Console) verknüpft ist.
Wichtige Informationen Verknüpfen Sie Ihre Google Cloud-Projekte in der Google Play Console mit Ihrer App oder in der Google Play SDK Console mit Ihrem SDK.
Fehler bei Kontingentüberschreitung Nicht verknüpfte Anfragen, die das Limit von 10.000 Anfragen pro Tag überschreiten, schlagen mit dem Fehler TOO_MANY_REQUESTS (Fehlercode -8) fehl.

Häufig gestellte Fragen

Die Play Integrity API bietet jedem Google Cloud-Projekt ein Standardkontingent von 10.000 Anfragen pro Tag. Entwickler, die ein höheres Volumen benötigen, können eine Kontingenterhöhung beantragen.

Um Ihre App oder Ihr SDK zu schützen und zu verhindern, dass nicht autorisierte Dritte Ihr Kontingent aufbrauchen, ist ein erhöhtes Tageskontingent ausschließlich auf Google Cloud-Projekte beschränkt, die in der Google Play Console mit Ihrer App oder in der Google Play SDK Console mit Ihrem SDK verknüpft sind.

Für Apps (Google Play Console):

  1. Melden Sie sich in der Google Play Console an und wählen Sie Ihre App aus.
  2. Gehen Sie im linken Navigationsmenü zu Mit Google Play geschützt.
  3. Wählen Sie neben Play Integrity API die Option Jetzt starten (oder Verwalten) aus.
  4. Klicken Sie auf Cloud-Projekt verknüpfen (oder auf Projekt hinzufügen, wenn Sie bereits Projekte verknüpft haben).
  5. Wählen Sie die Google Cloud-Projektnummer aus, die Sie verknüpfen möchten, oder geben Sie sie ein und bestätigen Sie die Auswahl.

Für SDKs (Google Play SDK Console):

  1. Melden Sie sich in der Google Play SDK Console an und wählen Sie Ihr SDK aus.
  2. Rufen Sie im linken Navigationsmenü SDK-Integrität auf.
  3. Klicken Sie neben Play Integrity API auf Einstellungen.
  4. Klicken Sie auf Cloud-Projekt verknüpfen (oder auf Weiteres hinzufügen, wenn Sie bereits verknüpfte Projekte haben).
  5. Wählen Sie die Google Cloud-Projektnummer aus, die Sie verknüpfen möchten, oder geben Sie sie ein und bestätigen Sie die Auswahl.

Erforderliche Berechtigungen:

  • Play Console (für Apps): Sie benötigen die Berechtigung Produktionsversionen veröffentlichen, Geräte ausschließen und Play App-Signatur verwenden für die App.
  • Play SDK Console (für SDKs): Sie benötigen die Berechtigung Verwalten für das SDK.
  • Google Cloud (beide): Sie benötigen die Berechtigungen serviceusage.services.enable und resourcemanager.projects.get für das Google Cloud-Zielprojekt.

Für Apps (Google Play Console):

  1. Öffnen Sie die Google Play Console > Mit Google Play geschützt > Play Integrity API > Verwalten.
  2. Sehen Sie sich den Abschnitt „Projektkonfiguration“ an.
  3. Achte darauf, dass die aufgeführte Projektnummer mit der Nummer übereinstimmt, die zum Aufrufen der Play Integrity API verwendet wird.

Für SDKs (Google Play SDK Console):

  1. Öffnen Sie die Google Play SDK Console > SDK-Integrität > Einstellungen.
  2. Sehen Sie sich den Abschnitt „Projektkonfiguration“ an.
  3. Achte darauf, dass die aufgeführte Projektnummer mit der Nummer übereinstimmt, die zum Aufrufen der Play Integrity API verwendet wird.

F4: Wie verknüpfe ich mein Cloud-Projekt, wenn meine App oder mein SDK nicht bei Google Play verfügbar ist?

Das Verknüpfen eines Google Cloud-Projekts ist nur für Apps, die in der Google Play Console verwaltet werden, und für SDKs, die in der Google Play SDK Console registriert sind, möglich.

Wenn Ihre App ausschließlich außerhalb von Google Play vertrieben wird oder Ihr SDK nicht in der Play SDK Console verfügbar ist, können Sie kein Google Cloud-Projekt verknüpfen. Der Play Integrity API-Traffic ist dann auf die standardmäßigen 10.000 Anfragen pro Tag beschränkt. Wenn Sie ein höheres Kontingent erhalten möchten, veröffentlichen Sie Ihre App bei Google Play oder registrieren Sie Ihr berechtigtes SDK in der Play SDK Console und verknüpfen Sie Ihr Cloud-Projekt.

F5: Kann ich mehrere Google Cloud-Projekte verknüpfen oder ein Projekt für mehrere Apps oder SDKs freigeben?

  • Mehrere Projekte pro App oder SDK:Sie können bis zu fünf Google Cloud-Projekte mit einer einzelnen App oder einem einzelnen SDK verknüpfen.
  • Ein Projekt für mehrere Apps:Sie können dasselbe Google Cloud-Projekt mit mehreren Apps in der Google Play Console verknüpfen. Das Verknüpfen desselben Google Cloud-Projekts mit mehreren SDKs oder mit einem SDK und einer App wird nicht unterstützt.

F6: Was ist, wenn ich die App oder das SDK verwalte, aber jemand anderes in meiner Organisation Inhaber des Google Cloud-Projekts ist?

Damit die Verknüpfung abgeschlossen werden kann, muss der Nutzer, der die Aktion in der Play Console (oder Play SDK Console) ausführt, auch die erforderlichen Berechtigungen für das Google Cloud-Projekt haben. Dafür gibt es zwei Möglichkeiten:

  • Option A: Bitten Sie jemanden, der den IAM-Zugriff auf das Google Cloud-Projekt verwalten kann, Ihrem Google-Konto vorübergehend die Berechtigungen serviceusage.services.enable und resourcemanager.projects.get zu gewähren. Nach der Verknüpfung sind diese Berechtigungen für den täglichen Betrieb nicht mehr erforderlich.
  • Option B: Gewähren Sie einem Teammitglied, das bereits die Berechtigungen serviceusage.services.enable und resourcemanager.projects.get für das Google Cloud-Projekt hat, die erforderliche Console-Berechtigung, damit es die Verknüpfung vornehmen kann:
    • Für Apps (Play Console): Gewähren Sie die Berechtigung Produktionsversionen veröffentlichen, Geräte ausschließen und Play App-Signatur verwenden für die App.
    • Für SDKs (Play SDK Console): Gewähren Sie die Berechtigung Verwalten für das SDK.

F7: Was passiert, wenn ich mein Cloud-Projekt nicht vor dem 16. Februar 2027 verknüpfe?

Wenn eine App oder ein SDK nach dem 16. Februar 2027 Play Integrity API-Anfragen über ein nicht verknüpftes Google Cloud-Projekt sendet, gilt Folgendes:

  1. Bis zu 10.000 Anfragen pro Tag:Anfragen werden im Rahmen des Standardgrundkontingents weiterhin normal verarbeitet.
  2. Über 10.000 Anfragen pro Tag:Sobald das nicht verknüpfte Projekt 10.000 Anfragen pro Tag erreicht, werden Anfragen mit dem Fehler TOO_MANY_REQUESTS (Fehlercode -8) abgelehnt.

Sofortige Self-Service-Fehlerbehebung:

Wenn Ihre App oder Ihr SDK nach Ablauf der Frist TOO_MANY_REQUESTS-Fehler erhält, weil kein Cloud-Projekt verknüpft wurde, können Sie das Problem beheben, indem Sie das fehlende Google Cloud-Projekt in der Play Console oder der Play SDK Console verknüpfen.

F8: Ich verwende die Play Integrity API nicht. Warum habe ich eine Nachricht erhalten, in der ich aufgefordert werde, mein Cloud-Projekt zu verknüpfen?

Sie erhalten diese Benachrichtigung,weil Ihr Google Cloud-Projekt mehr als 10.000 nicht verknüpfte Play Integrity API-Anfragen pro Tag generiert. Häufige Gründe dafür sind:

  1. Eine Bibliothek oder ein SDK, die bzw. das mit Ihrer Cloud-Projektnummer konfiguriert ist:Einige Bibliotheken rufen die Play Integrity API über Ihr Google Cloud-Projekt auf. Wenn Ihre App oder Ihr SDK eine solche Bibliothek verwendet, verknüpfen Sie das Projekt in der Play Console mit Ihrer App oder in der Play SDK Console mit Ihrem SDK.
  2. Eine andere App oder ein anderes Team in Ihrer Organisation:Ein anderes Team verwendet dieses Google Cloud-Projekt möglicherweise in seiner App oder seinem SDK. Wenden Sie sich an Ihre Entwicklungsteams, um die App oder das SDK zu identifizieren, und verknüpfen Sie das Projekt dann in der Play Console oder der Play SDK Console.
  3. Nicht autorisierter Traffic oder eine eingestellte Integration:Wenn nicht autorisierte oder geklonte Apps Anfragen mit Ihrer Projektnummer senden oder wenn Sie die API nicht mehr verwenden, ist keine Aktion erforderlich. Wenn Sie das Limit von 10.000 Anfragen pro Tag für nicht verknüpfte Anfragen aktivieren,wird der unerwünschte Traffic begrenzt.

Kontakt und Support

Wenn Sie Fragen zum Verknüpfen Ihres Cloud-Projekts oder zum Verwalten Ihres Play Integrity API-Kontingents haben: