常見錯誤

本頁列出常見錯誤，並提供防範及處理錯誤的訣竅。如需完整的錯誤清單，請參閱錯誤參照。如需進一步支援，請造訪我們的論壇。

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 天後過期。 預防秘訣 請參閱「未驗證的應用程式」。

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	摘要 一項要求中的兩項作業包含建立二進制資料資產的建立作業。 常見原因 包含重複建立作業 (內含相同二進位資料) 的 change 要求。 應對方式 在獨立要求中建立資產，然後在後續要求中連結至該資產；或者在相同要求中使用「臨時 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 相符的帳戶。 常見原因 嘗試存取的帳戶才剛在後端建立。 應對方式 先等待五分鐘，然後再每 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 指南。

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

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 用戶端憑證和授權使用者重複執行「Generate User credentials」(產生使用者憑證範例) 多次，就可能會發生這種情況。 應對方式 如要為指定的授權使用者和 OAuth 用戶端憑證組合重新產生更新權杖，請撤銷現有的更新權杖。請注意，撤銷權杖會使權杖無法使用，導致 Google Ads API 存取無法使用，且系統會將更新權杖產生的所有存取權杖失效。 預防秘訣 請務必將更新憑證儲存在安全的位置，以免需要重新產生。

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

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	摘要 指派給指定欄位的字串超過限制， 常見原因 廣告的標題或說明包含過多文字。 應對方式 找出目前遇到的限制，據此修改字串，然後重新傳送要求。 預防秘訣 請留意字串長度限制。