常見錯誤

本頁列出常見錯誤，並提供防止及處理這些錯誤的提示。如需完整的錯誤清單，請參閱錯誤參考資料。如需進一步支援，請造訪論壇。

`google.auth.exceptions.RefreshError`

invalid_grant

摘要	權杖已過期或撤銷。
常見原因	Google Cloud Platform 專案的`Testing`
應對方式	Google 專案的發布狀態為 `Testing`，因此更新權杖每 7 天就會過期，並收到 `invalid_grant` 錯誤。前往 Google API 控制台，然後前往 OAuth 同意畫面。接著，按照這些操作說明將發布狀態變更為 `In production`，以免更新權杖在 7 天後失效。
預防秘訣	請參閱「未驗證的應用程式」一文。

CLIENT_CUSTOMER_ID_INVALID

CLIENT_CUSTOMER_ID_IS_REQUIRED

摘要	未在 HTTP 標頭中指定用戶端客戶 ID。
常見原因	未在 HTTP 標頭中指定用戶端客戶 ID。
應對方式	不適用
預防秘訣	所有呼叫都需要用戶端 ID，因此請務必在 HTTP 標頭中指定。不妨使用我們的用戶端程式庫，這些程式庫也可以為您處理。

CUSTOMER_NOT_FOUND

GOOGLE_ACCOUNT_COOKIE_INVALID

摘要	要求標頭中的存取權杖無效或已過期。
常見原因	存取權杖已失效。
應對方式	要求新權杖。如果您使用的是 Google 提供的其中一個用戶端程式庫，請參閱該用戶端程式庫的說明文件，瞭解如何更新權杖。
預防秘訣	儲存並重複使用存取權杖，直到權杖過期為止。

NOT_ADS_USER

摘要	用來產生存取權杖的 Google 帳戶並未與任何 Google Ads 帳戶建立關聯。
常見原因	提供的登入資訊對應未啟用 Google Ads 的 Google 帳戶。
應對方式	請務必使用有效的 Google Ads 帳戶 (通常是管理員帳戶) 登入，以利執行 OAuth 流程。您也可以邀請這個 Google 帳戶存取現有 Google Ads 帳戶，方法是登入管理員帳戶，選取有問題的客戶或管理員帳戶，前往 `Tools and Settings > Access and security` 然後新增 Google 帳戶電子郵件地址。
預防秘訣	不適用

OAUTH_TOKEN_INVALID

摘要	標頭中的 OAuth 存取權杖無效。
常見原因	您透過 HTTP 標頭傳遞的存取權杖不正確。
應對方式	不適用
預防秘訣	請確認您已傳遞與帳戶相關聯的正確存取權杖。有時會與更新權杖和授權碼混淆。如果您想取得可存取管理員帳戶下所有客戶帳戶的憑證，請務必為管理員帳戶取得更新權杖。詳情請參閱存取權杖和更新權杖和 OAuth2 的相關指南。

CUSTOMER_NOT_ENABLED

摘要	無法存取客戶帳戶，因為該帳戶並非處於啟用狀態。
常見原因	如果客戶帳戶未完成註冊或停用，就會發生這種情況。
應對方式	登入 Google Ads 使用者介面，確認您已經完成這個帳戶的申請程序。如果 Google Ads 帳戶已停用，請參閱「重新啟用已取消的 Google Ads 帳戶」一文。
預防秘訣	您可以主動查看客戶帳戶是否已停用，方法是查看「已取消」狀態。

DEVELOPER_TOKEN_NOT_APPROVED

摘要	開發人員權杖僅限使用測試帳戶，並且嘗試存取非測試帳戶。
常見原因	使用測試開發人員權杖存取非測試帳戶。
應對方式	請確認您確實想要存取非測試帳戶。若是如此，請申請將開發人員權杖升級為標準或基本存取權。
預防秘訣	不適用

DEVELOPER_TOKEN_PROHIBITED

摘要	要求中傳送的專案無法使用開發人員權杖。
常見原因	每個 Google API 控制台專案都只能與一個管理員帳戶連結開發人員權杖。一旦您提出 Google Ads API 請求，開發人員權杖就會與 Google API 控制台專案永久配對。如果您不是使用新的 Google API 控制台專案，您會在傳送要求時收到 `DEVELOPER_TOKEN_PROHIBITED` 錯誤。
應對方式	不適用
預防秘訣	如果在新的管理員帳戶中切換為開發人員權杖，您就必須為使用新管理員權杖的 Google Ads API 要求建立新的 Google API 控制台專案。

USER_PERMISSION_DENIED

摘要	獲得授權的客戶無法存取營運客戶。
常見原因	以可存取管理員帳戶的使用者身分進行驗證，但未在要求中指定 `login-customer-id`。
應對方式	不適用
預防秘訣	將 `login-customer-id` 指定為不含連字號 (`-`) 的管理員帳戶 ID。用戶端程式庫內建這項功能。