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

Google 會在帳戶連結程序期間呼叫您的 OAuth2 端點。這些呼叫可能會因各種原因而失敗。系統會記錄這些錯誤的詳細資訊,您可以在雲端控制台專案的記錄檔探索工具頁面中監控這些錯誤。

篩選帳戶連結錯誤

在「Logs Explorer」頁面中,將查詢篩選器設為下列設定,然後按一下「Run Query」按鈕:

  • 資源:如果您是透過 Google 控制台的 Actions 建立專案,請選取「Google Assistant Action Project」;否則請選取「Google Project」選項。
  • 記錄名稱:選取「Google 帳戶連結」錯誤選項。
  • 嚴重性:設為「error」;所有帳戶連結項目都會歸類為錯誤。

您也可以更新「記錄瀏覽器」頁面頂端的時間範圍,以便依日期篩選記錄,如以下螢幕截圖所示:

圖 1. Logs Explorer 查詢篩選器

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

錯誤資料的內容

帳戶連結錯誤資料包含在錯誤項目的 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 要求參數:方法、主體、URI 和標頭。

requestresponse 欄位為選用欄位,因為在記錄檢視器中,這兩個欄位有時會分開為 2 個不同的項目。

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