常見錯誤

本頁列出常見錯誤，並提供防止及處理這些錯誤的提示。 如需完整的錯誤清單，請參閱錯誤參考資料。如需進一步支援，請造訪論壇。

google.auth.exceptions.RefreshError
invalid_grant	摘要 權杖已過期或撤銷。 常見原因 Google Cloud Platform 專案的Testing 應對方式 Google 專案的發布狀態為 Testing，因此更新權杖每 7 天就會過期，並收到 invalid_grant 錯誤。前往 Google API 控制台，然後前往 OAuth 同意畫面。接著，按照這些操作說明將發布狀態變更為 In production，以免更新權杖在 7 天後失效。 預防秘訣 請參閱「未驗證的應用程式」一文。

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	摘要 這個運算子無法與 Ad 子類別搭配使用。 常見原因 嘗試修改廣告的 status 以外的屬性。 應對方式 不適用 預防秘訣 廣告建立後就無法修改。如要修改廣告，您必須製作新廣告，然後移除舊廣告。不過，廣告的 status 可以使用 MutateAdGroupAds 修改。
INVALID_INPUT	摘要 廣告的其中一個欄位包含無效字元。 常見原因 在網址中使用特殊字元。 應對方式 不適用 預防秘訣 提出 API 要求前，請先驗證應用程式中的網址。
LINE_TOO_WIDE	摘要 廣告的其中一個欄位超過規定的長度上限。請參閱「文字廣告簡介」一文。 常見原因 一行文字過長。 應對方式 不適用 預防秘訣 提出 API 要求之前，請先驗證這行的長度。

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	摘要 這個標籤已經與部分廣告相關聯。 常見原因 嘗試將標籤與已經連結的廣告建立關聯。 應對方式 不適用 預防秘訣 請先檢查要新增的標籤是否已與廣告建立關聯。
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	摘要 有一項作業嘗試更新已移除的廣告。 常見原因 廣告移除後就無法再更新，包括狀態變更。 應對方式 不適用 預防秘訣 確認您的程式碼不會嘗試更新已移除的廣告。

AdGroupCriterionError
INVALID_KEYWORD_TEXT	摘要 關鍵字文字包含無效字元。請參閱「新增關鍵字」一文。 常見原因 關鍵字文字包含無效字元。 應對方式 不適用 預防秘訣 向 API 提出要求前，先驗證應用程式中的關鍵字文字。

AdGroupError
DUPLICATE_ADGROUP_NAME	摘要 新增或重新命名一個廣告群組，但該名稱已經由其他廣告群組使用。 常見原因 新建廣告群組，並沿用現有有效或已暫停的廣告群組名稱。 應對方式 記錄錯誤並向使用者顯示錯誤訊息、建議獨一無二的廣告群組名稱，或顯示已經使用的名稱清單。 預防秘訣 不適用

AssetError
DUPLICATE_ASSET	摘要 單一要求中的兩項作業包含對使用相同二進位資料的資產建立的建立作業。 常見原因 包含重複建立作業 (包含相同二進位資料) 的 變更 要求。 應對方式 請在個別要求中建立資產，然後在後續要求中連結該資產；或是在同一個要求中使用「臨時 ID」。 預防秘訣 不適用

AuthenticationError
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 的相關指南。

AuthorizationError
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。用戶端程式庫內建這項功能。

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	摘要 出價值不是帳戶幣別最低單位的倍數。舉例來說，$ 0.015 美元 (以微量為單位的 15000) 便不是有效的出價。 常見原因 不適用 應對方式 不適用 預防秘訣 確認出價為帳戶幣別最低單位的倍數。
BID_TOO_BIG	摘要 即使出價未在廣告活動預算內，系統仍會傳回這項錯誤。 常見原因 不適用 應對方式 不適用 預防秘訣 確認帳戶是否參與 Google Grants 廣告計畫。如果有，請將單次點擊出價限制在計畫規定的上限。

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	摘要 預算金額過低。 常見原因 不適用 應對方式 不適用 預防秘訣 確認預算金額大於或等於帳戶幣別的最低單位。
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	摘要 從微金額轉換為帳戶幣別的金額時，預算金額的小數點後位數將過多。 常見原因 不適用 應對方式 不適用 預防秘訣 確認預算金額可以用帳戶貨幣的最低單位除盡。

CampaignError
DUPLICATE_CAMPAIGN_NAME	摘要 新增或重新命名某個廣告活動，但該名稱已用於其他廣告活動。 常見原因 建立新的廣告活動，並採用現有的有效或已暫停廣告活動的名稱。 應對方式 記錄錯誤並向使用者顯示錯誤訊息、建議獨一無二的廣告活動名稱，或顯示已經使用的名稱清單。 預防秘訣 不適用

CriterionError
KEYWORD_HAS_INVALID_CHARS	摘要 新增或編輯包含無效字元的關鍵字。 常見原因 在關鍵字中使用特殊字元，例如 ! @ % *。 應對方式 不適用 預防秘訣 確定不要在關鍵字中使用任何不允許的字元。請參閱「新增關鍵字」一文。

DistinctError
DUPLICATE_ELEMENT	摘要 請求包含兩個相同且多餘的參數。 常見原因 不適用 應對方式 不適用 預防秘訣 提出請求前，先移除重複項目 (作業、參數、清單元素)。尋找具有 DistinctElements 限制的欄位。

InternalError
DEADLINE_EXCEEDED	摘要 要求已逾時，無法完成，因此無法傳回回應。 常見原因 收到的搜尋要求產生了過大的回應，或是修改請求太大，無法處理。 應對方式 請稍候 30 秒，然後再重試要求。如果錯誤持續發生，請嘗試將要求分成多項小型要求，以更快完成。 預防秘訣 查看區隔，瞭解這對回應大小有何影響。瞭解 gRPC 傳輸層限制。
INTERNAL_ERROR	摘要 處理要求時發生未預期的狀況。 常見原因 因為發生錯誤，導致 API 無法正常運作。 應對方式 使用指數輪詢時間表重試因這項錯誤失敗的所有要求。 預防秘訣 不適用
TRANSIENT_ERROR	摘要 發生暫時性的內部錯誤，應執行重試作業。 常見原因 當 API 內部發生暫時性問題時，就會發生這項錯誤。 應對方式 使用指數輪詢時間表重試因這項錯誤失敗的所有要求。 預防秘訣 不適用

InvalidGrantError
invalid_grant (malformed auth code)	摘要 交換 OAuth 權杖的授權碼格式錯誤。 常見原因 當嘗試為提出要求的使用者產生更新權杖時，就會發生這種情況。舉例來說，如果同一個 OAuth 用戶端憑證並授權使用者多次執行產生使用者憑證範例一次，就可能會發生這種情況。 應對方式 如要針對授權使用者和 OAuth 用戶端憑證的組合重新產生更新權杖，請撤銷現有的更新權杖。請注意，撤銷權杖後，該權杖將無法用於 Google Ads API 存取權，且用於產生更新權杖的所有存取權杖也會失效。 預防秘訣 請務必將更新權杖儲存在安全的位置，以免必須重新產生金鑰。

MutateError
RESOURCE_NOT_FOUND	摘要 找不到要求所參照的資源， 常見原因 此要求嘗試修改或以其他方式參照不存在或已遭移除的資源。或是資源的指定資源名稱格式錯誤。 應對方式 提交變更請求前，請先使用搜尋要求擷取現有資源的資源名稱。參閱用戶端程式庫指南，當中含有如何使用各種支援語言建立有效資源名稱的說明文件 預防秘訣 請勿手動建立資源名稱。使用 Google 用戶端程式庫提供的其中一個輔助方法。

NotEmptyError
EMPTY_LIST	摘要 必要清單空白。 常見原因 將空白的作業清單傳遞至 mutate 方法。 應對方式 不適用 預防秘訣 不適用

QuotaError
RESOURCE_EXHAUSTED	摘要 已超過系統頻率限制。 常見原因 不適用 應對方式 不適用 預防秘訣 設定每次要求之間的短暫延遲，或以較少的要求合併更多作業。

RangeError
TOO_LOW	摘要 值低於允許下限。 常見原因 忘記指定 ID，導致傳入 0 的值。 應對方式 不適用 預防秘訣 請特別留意 API 參考資料中記錄的所有範圍限制。

RequestError
INVALID_INPUT	摘要 要求格式錯誤。 常見原因 要求的網址或內容格式錯誤。 應對方式 不適用 預防秘訣 不適用
REQUIRED_FIELD_MISSING	摘要 請求中缺少必要資訊。 常見原因 嘗試新增實體時缺少必填欄位。 應對方式 記錄錯誤並向使用者顯示錯誤訊息。錯誤的 fieldPath 屬性會指出漏填的欄位。 預防秘訣 請參閱 API 參考資料，瞭解哪些欄位必填。

ResourceCountLimitExceededError
RESOURCE_LIMIT	摘要 這項要求嘗試建立資源，導致這些資源總數超過指定上限。 常見原因 在特定情境下，可存在的資源數量設有多項限制。 應對方式 請查看系統限制，瞭解目前面臨的限制。您可以重複使用現有的資源，或是移除資源以為新資源建立空間。 預防秘訣 使用搜尋查詢監控設有限制的資源數量。

StringLengthError
TOO_LONG	摘要 指派給指定欄位的字串超過限制。 常見原因 廣告的標題或說明包含過多文字。 應對方式 找出遇到的限制，並據此修改字串，然後重新傳送要求。 預防秘訣 瞭解字串長度限制。