本頁面由 Cloud Translation API 翻譯而成。

常見錯誤

本頁面列出常見錯誤，並提供相關的預防和處理訣竅。如需完整的錯誤清單，請參閱錯誤參考資料。如需進一步支援，請前往我們的論壇。

`google.auth.exceptions.RefreshError`

invalid_grant

摘要	權杖已過期或撤銷。
常見原因	已為外部使用者類型設定 OAuth 同意畫面，且發布狀態為 `Testing` 的 Google Cloud Platform 專案，會收到一個將於 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 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 帳戶」。
預防秘訣	您可以主動檢查客戶帳戶是否已停用，方法是查看狀態是否為「已取消」。

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，但不要加上連字號 (`-`)。用戶端程式庫已內建支援此功能。