監控 Google 控制台中的帳戶連結錯誤

Google 會在帳戶連結過程中，呼叫您的 OAuth2 端點。這些呼叫可能會因不同原因而失敗。系統會記錄這些錯誤的詳細資訊，您可以在 Cloud Console 專案的「記錄檔探索工具」頁面中監控這些錯誤。

篩選帳戶連結錯誤

在「記錄檔探索工具」頁面中，將查詢篩選器設為下列選項，然後按一下 [Run Query] 按鈕：

  • 資源：如果您是透過 Actions on Google Console 建立專案，請選取 [Google 助理動作專案]，否則請選取 [Google 專案] 選項。
  • 記錄名稱：選取 [Google 帳戶連結] 錯誤選項。
  • 嚴重性：設為 error；所有帳戶連結項目都會歸類為錯誤。

您也可以在「記錄檔探索工具」頁面頂端更新時間範圍，依日期篩選資料，如下方螢幕截圖所示：

圖 1. 記錄檔探索工具查詢篩選器

如要進一步瞭解如何使用記錄檔探索工具，請參閱記錄檔探索工具說明文件。

錯誤資料的內容

帳戶連結錯誤資料位於錯誤項目的 jsonPayload 屬性中。資料包括下列欄位：

  • @type (String)：一律設為 type.googleapis.com/google.identity.accountlinking.type.AccountLinkingError。
  • step (String)：發生錯誤的錯誤連結。設為下列其中一個值：
    • ACCOUNT_LINKING_STEP_UNDEFINED：未定義的步驟。
    • AUTH_CODE_EXCHANGE：交換存取碼或更新權杖的步驟。
    • REFRESH_ACCESS_TOKEN：重新整理存取權杖的步驟。
    • TOKEN_REVOCATION：撤銷權杖的步驟。
    • USERINFO：使用存取權杖擷取使用者資訊的步驟。
    • ASSERTION：宣告斷言的步驟。
  • response (String, optional)：代表 HTTP 回應：
    • status：HTTP 回應的狀態。
    • body：錯誤說明和錯誤字串。
  • request (String, optional)：代表 HTTP 要求，包含以下 HTTP 要求參數：method、body、URI 和標頭。

request 和 response 欄位為選用欄位，因為有時將這些記錄檔分成 2 個不同的記錄項目。

導入 Google 帳戶連結 OAuth 伺服器和簡化 Google 帳戶連結 OAuth 伺服器時，您必須針對不同的狀態使用特定 HTTP 回應代碼。您傳回的值必須符合說明文件中列出的正確狀態。