Google ruft Ihre OAuth2-Endpunkte während der Kontoverknüpfung auf. Diese Aufrufe können aus verschiedenen Gründen fehlschlagen. Für diese Fehler werden detaillierte Informationen protokolliert und Sie können sie auf der Log-Explorer-Seite Ihres Cloud Console-Projekts überwachen.
Nach Kontoverknüpfungsfehlern filtern
Legen Sie auf der Seite Log-Explorer die folgenden Abfragefilter fest und klicken Sie auf die Schaltfläche Abfrage ausführen:
- Ressource: Wählen Sie Google Assistant Action Project aus, wenn Sie das Projekt über Actions on Google Console erstellt haben. Andernfalls wählen Sie die Option Google Project aus.
- Log Name (Logname): Wählen Sie die Fehleroption Google Account Account (Google-Kontoverknüpfung) aus.
- Schweregrad: Wird auf error gesetzt. Alle Einträge zur Kontoverknüpfung werden als Fehler kategorisiert.
Sie können auch nach Datum filtern. Aktualisieren Sie dazu den Zeitraum oben auf der Log-Explorer-Seite (siehe Screenshot unten):
Abbildung 1. Log-Explorer-Abfragefilter
Weitere Informationen zur Verwendung des Log-Explorers finden Sie in der Dokumentation zum Log-Explorer.
Inhalt der Fehlerdaten
Die Fehler bei der Kontoverknüpfung sind in der Property jsonPayload
des Fehlereintrags enthalten. Die Daten umfassen die folgenden Felder:
@type
(String
): immer auftype.googleapis.com/google.identity.accountlinking.type.AccountLinkingError
festgelegt.step
(String
): Der Verknüpfungsschritt, bei dem der Fehler aufgetreten ist. Legen Sie einen der folgenden Werte fest:ACCOUNT_LINKING_STEP_UNDEFINED
: Ein nicht definierter Schritt.AUTH_CODE_EXCHANGE
: Schritt zum Austausch des Authentifizierungscodes für das Zugriffs- oder Aktualisierungstoken.REFRESH_ACCESS_TOKEN
: Schritt zum Aktualisieren eines Zugriffstokens.TOKEN_REVOCATION
: Schritt zum Widerrufen eines Tokens.USERINFO
: Schritt zum Abrufen von Nutzerinformationen mit einem Zugriffstoken.ASSERTION
: Schritt zum Erstellen einer Verknüpfung durch Assertion.
response
(String, optional
): steht für eine HTTP-Antwort:status
: Der Status der HTTP-Antwort.body
: Die Fehlerbeschreibung und der Fehlerstring.
request
(String, optional
): Stellt eine HTTP-Anfrage dar und enthält die folgenden HTTP-Anfrageparameter: Methode, Text, URI und Header.
Die Felder request
und response
sind optional, da sie in der Loganzeige manchmal in zwei verschiedene Einträge unterteilt sind.
Wenn Sie den OAuth-Server für die Google-Kontoverknüpfung und den OAuth-Server für die optimierte Google-Kontoverknüpfung implementieren, müssen Sie für die verschiedenen Bundesstaaten spezielle HTTP-Antwortcodes verwenden. Die zurückgegebenen Werte müssen dem korrekten Status in der Dokumentation entsprechen.