Wenn Ihre App eine Play Integrity API-Anfrage stellt und der Aufruf fehlschlägt, erhält Ihre App einen Fehlercode. Diese Fehler können verschiedene Ursachen haben, z. B. Umgebungsprobleme wie eine schlechte Netzwerkverbindung, Probleme mit Ihrer API-Integration oder schädliche Aktivitäten und aktive Angriffe. Der Typ des zurückgegebenen Fehlercodes hängt vom Typ der Anfrage ab:
- Standardanfragen: Die API gibt einen StandardIntegrityErrorCode zurück.
- Klassische Anfragen: Die API gibt einen IntegrityErrorCode zurück.
Wiederholungsstrategien
Verwenden Sie den exponentiellen Backoff für Play Integrity-Vorgänge, die im Hintergrund ausgeführt werden und die Nutzerfreundlichkeit während der Sitzung nicht beeinträchtigen.
Es ist beispielsweise sinnvoll, dies beim Bestätigen neuer Käufe zu implementieren, da dieser Vorgang im Hintergrund ausgeführt werden kann und die Bestätigung nicht in Echtzeit erfolgen muss, wenn ein Fehler auftritt.
Nach dem ersten Fehler wird eine anfängliche Verzögerung von 5 Sekunden festgelegt, bevor der Vorgang wiederholt wird.
Implementieren Sie eine Wiederholungsstrategie mit einer maximalen Anzahl von Versuchen als Abbruchbedingung und einer exponentiell zunehmenden Verzögerung (10 s, 20 s).
Prüfen Sie während dieser Wiederholungsversuche, ob eine Netzwerkverbindung besteht, und überlasten Sie das Gerät nicht.
Wenn nach drei Wiederholungsversuchen weiterhin Fehler auftreten, behandeln Sie das Ergebnis so, als ob der Client alle Integritätsprüfungen nicht bestanden hätte. Der Fehler kann verschiedene Ursachen haben, z. B. ein überlastetes Gerät, Probleme mit der Netzwerkverbindung oder ein Angriff.
Fehlercodewerte für die Java-Bibliothek
Zusätzliche Fehlercodewerte für die native Bibliothek
Fehlercodes, die Sie wiederholen können
Die Ursache dieser Fehler sind manchmal vorübergehende Bedingungen. Sie sollten den Aufruf daher wiederholen.
NETWORK_ERROR (Fehlercode -3)
Dieser Fehler weist darauf hin, dass ein Problem mit der Netzwerkverbindung zwischen dem Gerät und den Play-Systemen aufgetreten ist.
Mögliche Lösung
- Verwende das Dialogfeld
GET_INTEGRITYoderGET_STRONG_INTEGRITY, um eine von Google Play geführte Umgebung zu starten, die dem Nutzer hilft, die Netzwerkverbindung herzustellen und zu bestätigen. - Bitte den Nutzer, die Netzwerkverbindung zu prüfen und je nachdem, welche Aktion den Fehler ausgelöst hat, einfache Wiederholungsversuche oder exponentielles Backoff zu verwenden.
Weitere Informationen
NETWORK_ERROR für klassische Anfragen.
TOO_MANY_REQUESTS (Fehlercode -8)
Die aufrufende App stellt zu viele Anfragen an die API und wurde gedrosselt oder Ihre App hat ihr tägliches Anfragekontingent überschritten.
Mögliche Lösung
- Wiederholen Sie den Vorgang mit exponentiellem Backoff.
- Erhöhung des Tageslimits für Anfragen beantragen
Weitere Informationen
TOO_MANY_REQUESTS für klassische Anfragen.
GOOGLE_SERVER_UNAVAILABLE (Fehlercode -12)
Unbekannter interner Google-Serverfehler.
Mögliche Lösung
Wiederholen Sie den Vorgang mit exponentiellem Backoff. Wenn der Fehler immer wieder auftritt, melde das Problem über das Supportformular für die Play Integrity API.
Weitere Informationen
GOOGLE_SERVER_UNAVAILABLE für klassische Anfragen.
CLIENT_TRANSIENT_ERROR (Fehlercode -18)
Auf dem Clientgerät ist ein vorübergehender Fehler aufgetreten.
Bei Standard-API-Anfragen wird dies ab Version 1.3.0 der Play Integrity API-Bibliothek für Kotlin und Java, ab Version 1.3.0 des Google Play Integrity-Plug-ins für Unity und ab Version 1.13.0 des Play Core Native SDK unterstützt.
Mögliche Lösung
Wiederholen Sie den Vorgang mit exponentiellem Backoff.
Weitere Informationen
CLIENT_TRANSIENT_ERROR für klassische Anfragen.
Hinweis: Wenn dieser Wert bei einer API-Anfrage über die Classic API gemeldet wird, wird der Wert -17 zurückgegeben.
INTERNAL_ERROR (Fehlercode -100)
Unbekannter interner Fehler.
Mögliche Lösung
Wiederholen Sie den Vorgang mit exponentiellem Backoff. Wenn der Fehler immer wieder auftritt, melde das Problem über das Supportformular für die Play Integrity API.
Weitere Informationen
INTERNAL_ERROR für klassische Anfragen.
STANDARD_INTEGRITY_INTERNAL_ERROR (Fehlercode -100)
Unbekannter interner Fehler.
Mögliche Lösung
Wiederholen Sie den Vorgang mit exponentiellem Backoff. Wenn der Fehler immer wieder auftritt, melde das Problem über das Supportformular für die Play Integrity API.
Weitere Informationen
Informationen zu klassischen Anfragen finden Sie unter INTEGRITY_INTERNAL_ERROR.
STANDARD_INTEGRITY_INITIALIZATION_FAILED (Fehlercode -102)
Beim Initialisieren der Standard Integrity API ist ein Fehler aufgetreten.
Mögliche Lösung
Wiederholen Sie den Vorgang mit exponentiellem Backoff. Wenn der Fehler immer wieder auftritt, melde das Problem über das Supportformular für die Play Integrity API.
Weitere Informationen
Informationen zu klassischen Anfragen finden Sie unter INTEGRITY_INITIALIZATION_FAILED.
Fehlercodes, die nicht wiederholt werden sollen
Automatische Wiederholungsversuche sind in diesen Fällen wahrscheinlich nicht hilfreich. Ein manueller Wiederholungsversuch kann jedoch hilfreich sein, wenn der Nutzer die Ursache des Problems behebt. Wenn der Nutzer beispielsweise seine Google Play Store-Version auf eine unterstützte Version aktualisiert, kann ein manueller Wiederholungsversuch des ursprünglichen Vorgangs funktionieren.
API_NOT_AVAILABLE (Fehlercode -1)
Die auf dem Gerät installierte Google Play Store-Version ist möglicherweise veraltet und die Integrity API ist nicht verfügbar. Eine weitere Möglichkeit ist, dass die Integrity API in der Google Play Console nicht aktiviert ist.
Mögliche Lösung
- Prüfen Sie, ob die Integrity API in der Google Play Console aktiviert ist.
- Bitten Sie den Nutzer, den Play Store zu aktualisieren.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter API_NOT_AVAILABLE.
PLAY_STORE_NOT_FOUND (Fehlercode -2)
Auf dem Gerät wurde keine offizielle Google Play Store App gefunden.
Mögliche Lösung
Bitten Sie den Nutzer, den Google Play Store zu installieren oder zu aktivieren.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter PLAY_STORE_NOT_FOUND.
PLAY_STORE_ACCOUNT_NOT_FOUND (Fehlercode -4)
Hinweis: Dies wird nur für klassische Anfragen über IntegrityErrorCode gemeldet.
Auf dem Gerät wurde kein Google Play Store-Konto gefunden. Die Play Integrity API unterstützt jetzt nicht authentifizierte Anfragen. Dieser Fehlercode wird nur für ältere Google Play Store-Versionen verwendet, die nicht unterstützt werden.
Mögliche Lösung
Bitten Sie den Nutzer, den Google Play Store zu aktualisieren und sich anzumelden.
APP_NOT_INSTALLED (Fehlercode -5)
Die Anruf-App ist nicht installiert. Etwas stimmt nicht (möglicherweise ein Angriff).
Mögliche Lösung
Keine Aktion möglich. Behandle das Ergebnis so, als hätte der Client alle Integritätsprüfungen nicht bestanden.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter APP_NOT_INSTALLED.
PLAY_SERVICES_NOT_FOUND (Fehlercode -6)
Die Google Play-Dienste sind nicht verfügbar oder müssen aktualisiert werden.
Mögliche Lösung
- Verwende das Dialogfeld
GET_INTEGRITYoderGET_STRONG_INTEGRITY, um einen von Google Play geführten Prozess zu starten, der den Nutzer bei der Installation, Aktualisierung oder Aktivierung der Google Play-Dienste unterstützt. - Bitten Sie den Nutzer, die Google Play-Dienste zu installieren, zu aktualisieren oder zu aktivieren.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter APP_NOT_INSTALLED.
APP_UID_MISMATCH (Fehlercode -7)
Die UID (Nutzer-ID) der Anruf-App stimmt nicht mit der UID des Paketmanagers überein.
Mögliche Lösung
Keine Aktion möglich. Behandle das Ergebnis so, als hätte der Client alle Integritätsprüfungen nicht bestanden.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter APP_UID_MISMATCH.
CANNOT_BIND_TO_SERVICE (Fehlercode -9)
Die Bindung an den Dienst im Google Play Store ist fehlgeschlagen. Dies kann daran liegen, dass auf dem Gerät eine alte Google Play Store-Version installiert ist.
Mögliche Lösung
Bitten Sie den Nutzer, den Google Play Store zu aktualisieren.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter CANNOT_BIND_TO_SERVICE.
NONCE_TOO_SHORT (Fehlercode -10)
Hinweis: Dies wird nur für klassische Anfragen über IntegrityErrorCode gemeldet.
Die Nonce-Länge ist zu kurz. Die Nonce muss vor der Base64-Codierung mindestens 16 Byte lang sein.
Mögliche Lösung
Versuchen Sie es mit einer längeren Nonce noch einmal.
NONCE_TOO_LONG (Fehlercode -11)
Hinweis: Dies wird nur für klassische Anfragen über IntegrityErrorCode gemeldet.
Die Nonce ist zu lang. Die Nonce muss vor der Base64-Codierung kleiner als 500 Byte sein.
Mögliche Lösung
Versuchen Sie es mit einer kürzeren Nonce noch einmal.
NONCE_IS_NOT_BASE64 (Fehlercode -13)
Hinweis: Dies wird nur für klassische Anfragen über IntegrityErrorCode gemeldet.
Die Nonce ist nicht als websicherer Base64-String ohne Zeilenumbruch codiert.
Mögliche Lösung
Versuchen Sie es mit einer Nonce im richtigen Format noch einmal.
PLAY_STORE_VERSION_OUTDATED (Fehlercode -14)
Die Google Play Store App muss aktualisiert werden.
Mögliche Lösung
Bitten Sie den Nutzer, den Google Play Store zu aktualisieren.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter PLAY_STORE_VERSION_OUTDATED.
PLAY_SERVICES_VERSION_OUTDATED (Fehlercode -15)
Die Google Play-Dienste müssen aktualisiert werden.
Mögliche Lösung
- Verwende das Dialogfeld
GET_INTEGRITYoderGET_STRONG_INTEGRITY, um eine von Google Play geführte Oberfläche zu starten, die dem Nutzer hilft, die Google Play-Dienste zu aktualisieren. - Bitte den Nutzer, die Google Play-Dienste zu aktualisieren.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter PLAY_SERVICES_VERSION_OUTDATED.
CLOUD_PROJECT_NUMBER_IS_INVALID (Fehlercode -16)
Die angegebene Cloud-Projektnummer ist ungültig.
Mögliche Lösung
Verwenden Sie die Cloud-Projektnummer für das Cloud-Projekt, für das Sie die Play Integrity API aktiviert haben.
Weitere Informationen
Informationen zur klassischen Anfrage finden Sie unter CLOUD_PROJECT_NUMBER_IS_INVALID.
REQUEST_HASH_TOO_LONG (Fehlercode -17)
Hinweis: Dies wird nur gemeldet, wenn Sie eine Standardanfrage über StandardIntegrityErrorCode verwenden.
Der angegebene requestHash ist zu lang. Die Länge von requestHash muss weniger als 500 Zeichen betragen.
Mögliche Lösung
Versuchen Sie es mit einem kürzeren requestHash noch einmal.
INTEGRITY_TOKEN_PROVIDER_INVALID (Fehlercode -19)
Hinweis: Dies wird nur für Standardanfragen über StandardIntegrityErrorCode gemeldet.
Der StandardIntegrityTokenProvider ist nicht mehr gültig.
Das kann passieren, weil der Tokenanbieter abgelaufen ist oder der Nutzer die Daten der Play Store App gelöscht hat, wodurch der Tokenanbieter entfernt wurde.
Dieser Fehlercode ist nur für Standard-API-Anfragen verfügbar. Er wird ab Bibliotheksversion 1.3.0 für die Programmiersprachen Kotlin und Java, ab Google Play Integrity-Plug-in für Unity 1.3.0 und ab Play Core Native SDK 1.13.0 unterstützt.
Mögliche Lösung
Fordern Sie einen neuen Integritätstoken-Anbieter an.
STANDARD_INTEGRITY_INITIALIZATION_NEEDED (Fehlercode -101)
StandardIntegrityManager ist nicht initialisiert.
Mögliche Lösung
Rufe zuerst StandardIntegrityManager_init() an.
Weitere Informationen
INTEGRITY_INITIALIZATION_NEEDED für klassische Anfragen ansehen
STANDARD_INTEGRITY_INVALID_ARGUMENT (Fehlercode -103)
An die Standard Integrity API wurde ein ungültiges Argument übergeben.
Mögliche Lösung
Versuchen Sie es mit dem richtigen Argument noch einmal.
Weitere Informationen
Weitere Informationen finden Sie unter INTEGRITY_INVALID_ARGUMENT für klassische Anfragen.