提供意見
常見錯誤
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本頁列出常見錯誤,並提供防止及處理這些錯誤的提示。
如需完整的錯誤清單,請參閱錯誤參考資料 。如需進一步支援,請造訪論壇 。
google.auth.exceptions.RefreshError
invalid_grant
摘要 權杖已過期或撤銷。
常見原因
Google Cloud Platform 專案的Testing
應對方式
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 相符的帳戶。
常見原因
嘗試存取的帳戶才剛建立,而且是在後端建立該帳戶。
應對方式
請等待 5 分鐘,之後每 30 秒重試一次。
預防秘訣
建立帳戶後,請等待幾分鐘再對帳戶發出請求。
GOOGLE_ACCOUNT_COOKIE_INVALID
摘要 要求標頭中的存取權杖無效或已過期。
常見原因
存取權杖已失效。
應對方式
要求 新權杖。如果您使用的是 Google 提供的其中一個用戶端程式庫,請參閱該用戶端程式庫的說明文件,瞭解如何更新權杖。
預防秘訣
儲存並重複使用存取權杖,直到權杖過期為止。
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 帳戶已停用,請參閱「重新啟用已取消的 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。用戶端程式庫內建這項功能。
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-06-26 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
想進一步說明嗎?
{
"last_modified": "上次更新時間:2024-06-26 (世界標準時間)。",
"state": ""
}