常見錯誤
透過集合功能整理內容你可以依據偏好儲存及分類內容。

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

`google.rpc.ErrorInfo`

ACCESS_TOKEN_SCOPE_INSUFFICIENT

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

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 指南。

ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN

摘要	開發人員權杖已與 Google Cloud 機構建立關聯，無法與其他機構建立關聯。
常見原因	開發人員權杖與 Google Cloud 專案的關聯，並非與原本用於提出要求的 Google Cloud 專案相同，而是與同一個 Google Cloud 機構中的 Google Cloud 專案相關聯。
處理方式	如果您已使用開發人員權杖提出 API 要求，請確認 OAuth 用戶端 ID 與同一個 Google Cloud 組織中的 Google Cloud 專案相關聯。
預防秘訣	請務必將所有 Google Cloud 專案與同一個 Google Cloud 機構建立關聯。一個 Google Cloud 專案只能與一個開發人員憑證關聯，但一個開發人員憑證可以與機構中的多個專案關聯。

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