Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

常見錯誤

本指南列出常見的 API 錯誤，並提供預防及處理這些錯誤的策略。

如需所有錯誤類型的完整清單，請參閱 Google Ads API 錯誤參考資料。如需其他協助，請在 Google Ads API 論壇提問。

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

摘要	OAuth 2.0 存取權杖沒有必要的範圍。
常見原因	由於提供的存取權杖未包含 Google Ads API OAuth 2.0 範圍，因此要求遭到拒絕。
如何處理	請確認存取權杖具有必要範圍。造成這項錯誤的常見原因，是您重複使用以不同 OAuth 範圍集產生的現有存取權杖。如要瞭解如何使用必要範圍產生新的存取權杖，請參閱 OAuth 授權參數。
預防秘訣	確認存取權杖具有必要範圍。使用必要範圍重新驗證使用者，取得具有必要範圍的存取權。如果應用程式使用多個 OAuth 範圍，您可能需要實作精細 OAuth 權限。

invalid_grant

摘要	權杖已過期或撤銷。
常見原因	如果 Google Cloud Platform 專案的 OAuth 同意畫面是為外部使用者類型設定，且發布狀態為「`Testing`」，系統會核發 7 天後過期的更新權杖。
如何處理	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

摘要	要求標頭中的存取權杖無效或已過期。
常見原因	存取權杖已失效。
如何處理	要求新權杖。如果您使用我們的用戶端程式庫，請參閱相關說明文件，瞭解如何重新整理權杖。
預防秘訣	儲存並重複使用存取權杖，直到權杖過期為止。

NOT_ADS_USER

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

OAUTH_TOKEN_INVALID

摘要	標頭中的 OAuth 存取權杖無效。
常見原因	透過 HTTP 標頭傳遞的存取權杖有誤。
如何處理	不適用
預防秘訣	請確認您已傳遞與帳戶相關聯的正確存取權杖。有時會與重新整理權杖和授權碼混淆。如要取得可存取管理員帳戶下所有客戶帳戶的憑證，請務必取得管理員帳戶的重新整理權杖。請參閱使用者驗證指南。

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION

摘要	Google Cloud 雲端專案僅有測試存取權，無法用來存取正式版帳戶。
常見原因	您使用測試存取層級的 Google Cloud 雲端專案，對非測試 (正式) Google Ads 帳戶發出要求。(在 API 24 以下版本中，這個條件會傳回 `AuthorizationError.ACTION_NOT_PERMITTED`。)
如何處理	如果正在測試，請確保要求是以測試帳戶為目標。如要存取正式版 Google Ads 帳戶，請在 Google Ads API 總覽頁面查看 Google Cloud 專案的存取層級，並將專案的存取層級升級為探索者、基本或標準存取權。
預防秘訣	不適用

CUSTOMER_NOT_ENABLED

摘要	客戶帳戶未啟用，因此無法存取。
常見原因	如果顧客帳戶尚未完成註冊或已停用，就會發生這種情況。
如何處理	登入 Google Ads 使用者介面，確認您已完成這個帳戶的註冊程序。如要瞭解如何重新啟用已停用的帳戶，請參閱「重新啟用已取消的 Google Ads 帳戶」。
預防秘訣	您可以主動檢查客戶帳戶是否已停用，方法是查看狀態是否為「已取消」。

USER_PERMISSION_DENIED

摘要	獲得授權的客戶無法存取作業客戶。
常見原因	以有權存取管理員帳戶的使用者身分進行驗證，但未在要求中指定 `login-customer-id`。
如何處理	不適用
預防秘訣	請指定不含連字號的管理員帳戶 ID (`login-customer-id`)，例如 `-`。用戶端程式庫已內建這項支援功能。