本頁列出常見錯誤，並提供防範及處理錯誤的訣竅。如需完整的錯誤清單，請參閱錯誤參照。如需進一步支援，請造訪我們的論壇。
google.auth.exceptions.RefreshError
|
invalid_grant |
| 摘要 | 權杖已過期或撤銷， |
|---|
| 常見原因 |
Google Cloud Platform 專案含有針對外部使用者類型設定 OAuth 同意畫面且發布狀態為 Testing 的 Google Cloud Platform 專案，產生的更新權杖將於 7 天後到期。 |
|---|
| 應對方式 |
您 Google 專案的發布狀態為 Testing，因此更新權杖會每 7 天到期，並收到 invalid_grant 錯誤。前往 Google API 控制台，然後前往「OAuth 同意」畫面。接著，請按照這些操作說明將發布狀態變更為 In production，避免更新權杖在 7 天後過期。
|
|---|
| 預防秘訣 |
請參閱「未驗證的應用程式」。
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| 摘要 | 用戶端客戶 ID 不是數字。 |
|---|
| 常見原因 |
使用不正確的客戶 ID。
|
|---|
| 應對方式 |
不適用
|
|---|
| 預防秘訣 |
123-456-7890 應為 1234567890。詳情請參閱「開始使用」一文。
|
|---|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
| 摘要 | 未在 HTTP 標頭中指定用戶端客戶 ID。 |
|---|
| 常見原因 |
未在 HTTP 標頭中指定用戶端的客戶 ID。 |
|---|
| 應對方式 |
不適用
|
|---|
| 預防秘訣 |
所有呼叫都必須提供用戶端客戶 ID，因此請確定您已在 HTTP 標頭中指定。請考慮使用用戶端程式庫，由他們為您處理。 |
|---|
|
CUSTOMER_NOT_FOUND |
| 摘要 | 找不到與標頭中客戶 ID 相符的帳戶。 |
|---|
| 常見原因 |
嘗試存取的帳戶才剛在後端建立。 |
|---|
| 應對方式 |
先等待五分鐘，然後再每 30 秒重試。 |
|---|
| 預防秘訣 |
帳戶建立完成後，請先稍等幾分鐘，再對帳戶發出要求。 |
|---|
|
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。用戶端程式庫已內建可支援這項功能。 |
|---|
|
