Fehler bei der Kontoverknüpfung im Google Console-Projekt beobachten

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 auf type.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.