監控 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 和標頭。

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

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