Monitorowanie błędów połączenia kont w projekcie Google Console

Podczas łączenia kont Google nawiązuje połączenia z punktami końcowymi OAuth2. Mogą się one nie udać z różnych powodów. Szczegółowe informacje na temat tych błędów są rejestrowane na stronie Eksploratora logów projektu w konsoli Google Cloud.

Filtrowanie pod kątem błędów w łączeniu kont

Na stronie Eksploratora logów ustaw te filtry zapytania i kliknij przycisk Uruchom zapytanie:

  • Zasób: wybierz Projekt Asystenta Google, jeśli projekt został utworzony za pomocą Konsoli Play na koncie Google Actions. W przeciwnym razie wybierz opcję Projekt Google.
  • Nazwa dziennika: wybierz opcję błędu Łączenie kont Google.
  • Waga: ustaw błąd; wszystkie wpisy dotyczące łączenia kont są klasyfikowane jako błędy.

Możesz też filtrować dane według daty, aktualizując zakres czasu u góry strony Eksploratora logów, jak na tym zrzucie ekranu:

Rysunek 1. Filtry zapytań w eksploratorze logów

Więcej informacji o korzystaniu z eksploratora logów znajdziesz w dokumentacji eksploratora logów.

Treść danych o błędach

Dane błędu połączenia kont są zawarte we właściwości jsonPayload wpisu błędu. Dane zawierają te pola:

  • @type (String): zawsze ustawiona na type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError.
  • step (String): etap łączenia, podczas którego wystąpił błąd. Ustaw jedną z tych wartości:
    • ACCOUNT_LINKING_STEP_UNDEFINED: nieokreślony krok.
    • AUTH_CODE_EXCHANGE: etap wymiany kodu uwierzytelniania na dostęp lub token odświeżania.
    • REFRESH_ACCESS_TOKEN: krok polegający na odświeżeniu tokena dostępu.
    • TOKEN_REVOCATION: krok pozwalające unieważnić token.
    • USERINFO: etap pobierania informacji o użytkowniku za pomocą tokena dostępu.
    • ASSERTION: etap tworzenia linku jako potwierdzenia.
  • response (String, optional): reprezentuje odpowiedź HTTP:
    • status: stan odpowiedzi HTTP.
    • body: opis błędu i ciąg znaków błędu.
  • request (String, optional): reprezentuje żądanie HTTP i zawiera te parametry żądania HTTP: metoda, treść, identyfikator URI i nagłówki.

Pola request i response są opcjonalne, ponieważ czasami w przeglądarce logów są one podzielone na 2 różne pozycje.

Podczas wdrażania serwera protokołu OAuth połączonego konta Google i serwera uproszczonego połączenia konta Google musisz używać określonych kodów odpowiedzi HTTP w różnych stanach. Zwrócone wartości muszą być zgodne ze stanem podanym w dokumentacji.