常見錯誤

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

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

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
摘要這個運算子無法與廣告的子類別搭配使用。
常見原因 嘗試修改廣告的 status 以外的屬性。
處理方式 不適用
預防秘訣 廣告建立後即無法修改。如要修改廣告，您必須建立新廣告，然後移除舊廣告。不過，您可以使用 MutateAdGroupAds 修改廣告的 status。
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 對應的帳戶。
常見原因 在後端建立帳戶前，嘗試存取剛建立的帳戶。
處理方式 請先等候五分鐘，然後每隔 30 秒重試一次。
預防秘訣 建立帳戶後，請稍候幾分鐘再針對該帳戶提出要求。
摘要要求標頭中的存取權權杖無效或已過期。
常見原因 存取權杖已失效。
處理方式 要求新的權杖。如果您使用其中一種用戶端程式庫，請參閱相關說明文件，瞭解如何重新整理權杖。
預防秘訣 儲存並重複使用存取權杖，直到權杖過期為止。
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 廣告贊助金。如果是這樣，請將單次點擊出價限制在計畫規定的最高金額。

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

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