常見錯誤

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

`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 標頭中指定 ID。建議使用我們的用戶端程式庫，因為這些程式庫會為您處理這項作業。

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 標頭傳遞的存取權杖有誤。
如何處理	不適用
預防秘訣	請確認您已傳遞與帳戶相關聯的正確存取權杖。這有時會與重新整理權杖和授權碼混淆。如要取得可存取管理員帳戶下所有客戶帳戶的憑證，請務必取得管理員帳戶的重新整理權杖。詳情請參閱存取權杖和重新整理權杖以及 OAuth2 指南。

ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN

摘要	開發人員權杖已與 Google Cloud 機構建立關聯，無法再與其他機構建立關聯。
常見原因	開發人員權杖未與 Google Cloud 專案建立關聯，且該專案與用於原始要求的 Google Cloud 專案位於相同的 Google Cloud 機構。
如何處理	如果您已使用開發人員權杖提出 API 要求，請確認 OAuth 用戶端 ID 與相同 Google Cloud 機構中的 Google Cloud 專案相關聯。
預防秘訣	請務必將所有 Google Cloud 專案與同一個 Google Cloud 機構建立關聯。每個 Google Cloud 專案只能與一個開發人員權杖建立關聯，但一個開發人員權杖可以與機構中的多個專案建立關聯。

DEVELOPER_TOKEN_INVALID

摘要	開發人員權杖無效。
常見原因	這項錯誤的常見原因包括開發人員權杖有錯字，或是在不同的要求標頭中錯誤設定開發人員權杖。
如何處理	請務必從 API 中心複製開發人員權杖，以免發生錯字。您可以在 Google Ads 管理員帳戶中找到 API 中心。此外，也請確認您在正確的標頭中設定開發人員權杖。開發人員權杖有時會與 OAuth 更新權杖和授權碼混淆。如要進一步瞭解不同的要求標頭，請參閱這篇文章。
預防秘訣	不適用

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