Kontoverknüpfungsfehler im Google Console-Projekt beobachten

Google ruft während der Kontoverknüpfung deine OAuth2-Endpunkte 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 Seite Log-Explorer Ihres Cloud Console-Projekts überwachen.

Nach Kontoverknüpfungsfehler 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-Aktionsprojekt aus, wenn Sie das Projekt über die Actions on Google Console erstellt haben. Andernfalls wählen Sie die Option Google-Projekt aus.
  • Log Name (Protokollname): Wählen Sie die Fehleroption Google Account Linking (Google-Kontoverknüpfung) aus.
  • Schweregrad: Legen Sie error fest. Alle Einträge für die Kontoverknüpfung werden als Fehler kategorisiert.

Sie können auch nach Datum filtern, indem Sie oben auf der Seite „Log-Explorer“ den Zeitraum aktualisieren, wie im folgenden Screenshot dargestellt:

Abbildung 1. Abfragefilter im Log-Explorer

Weitere Informationen zur Verwendung des Log-Explorers finden Sie in der Log-Explorer-Dokumentation.

Inhalt der Fehlerdaten

Die Daten zu Fehlern bei der Kontoverknüpfung sind im Attribut jsonPayload des Fehlereintrags enthalten. Die Daten enthalten die folgenden Felder:

  • @type (String): Muss immer auf type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError gesetzt sein.
  • 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: Der Schritt, bei dem der Autorisierungscode gegen ein Zugriffs- oder Aktualisierungstoken eingetauscht wird.
    • REFRESH_ACCESS_TOKEN: Der Schritt zum Aktualisieren eines Zugriffstokens.
    • TOKEN_REVOCATION: Der Schritt zum Widerrufen eines Tokens.
    • USERINFO: Der Schritt zum Abrufen von Nutzerinformationen mit einem Zugriffstoken.
    • ASSERTION: Der Schritt zum Erstellen einer Verknüpfung durch Behauptung.
  • 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: „method“, „body“, „URI“ und „headers“.

Die Felder request und response sind optional, da sie in der Loganzeige manchmal auf zwei verschiedene Einträge aufgeteilt werden.

Wenn du deinen OAuth-Server für die Google-Kontoverknüpfung und den optimierten OAuth-Server für die Google-Kontoverknüpfung implementierst, musst du für verschiedene Status bestimmte HTTP-Antwortcodes verwenden. Die zurückgegebenen Werte müssen dem in der Dokumentation aufgeführten Status entsprechen.