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 回應代碼。您傳回的值必須對應至說明文件中列出的正確狀態。