系統限制

本頁列出 Google Ads API 中的各種限制，以及超出限制時會發生的對應錯誤。

如要瞭解產品限制 (例如每個帳戶的廣告活動數量上限)，請參閱「關於 Google Ads 帳戶限制」一文。

Account
管理員帳戶階層中的 Google Ads 帳戶數量上限	值 多樣性 發生錯誤 ManagerLinkError.TOO_MANY_ACCOUNTS 預防方式 詳情請參閱「關於管理員帳戶的帳戶上限」一文。
管理員帳戶階層中的測試帳戶數量上限	值 50 發生錯誤 ManagerLinkError.TOO_MANY_ACCOUNTS 預防方式 --
單一 Google Ads 帳戶可管理的管理員帳戶數量上限	值 5 發生錯誤 ManagerLinkError.TOO_MANY_MANAGERS 預防方式 詳情請參閱「關於管理員連結錯誤」一文。
階層內的層級數量上限 (從頂層管理員帳戶到最底層的 Google Ads 帳戶)	值 6 發生錯誤 ManagerLinkError.MAX_DEPTH_EXCEEDED 預防方式 詳情請參閱「關於管理員連結錯誤」一文。
同一階層中待處理管理員帳戶的邀請數量上限	值 20 發生錯誤 ManagerLinkError.TOO_MANY_INVITES 預防方式 詳情請參閱「關於管理員連結錯誤」一文。
名稱長度	值 255 個字元 發生錯誤 StringLengthError.TOO_LONG 預防方式 --

Ads
標題長度	值 30 個字元 發生錯誤 AdError.LINE_TOO_WIDE 預防方式 詳情請參閱「關於文字廣告」一文。
Description1 或 description2 長度	值 90 個字元 發生錯誤 AdError.LINE_TOO_WIDE 預防方式 如上所示。
Path1 或 path2 長度	值 15 個字元 發生錯誤 AdError.LINE_TOO_WIDE 預防方式 如上所示。
最終到達網址長度	值 2,084 個位元組 發生錯誤 StringLengthError.TOO_LONG 預防方式 最終到達網址必須包含通訊協定前置字元 (例如「https://」)，因此這類字串會計入這項限制。

Ad group
名稱長度	值 256 個字元 發生錯誤 AdGroupError.INVALID_ADGROUP_NAME 預防方式 --

Campaign budget
單一帳戶的共用預算數量上限	值 11,000 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 預算上限比廣告活動數量上限多出 1,000，可在必要時重新指派預算。可共用預算的廣告活動數量沒有限制。
帳戶中的未共用預算數量上限	值 20,000 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 這些預算與特定廣告活動相關聯，無法與其他廣告活動共用。

Campaign
每個廣告活動的廣告群組可附加的出價策略數量上限	值 1,000 發生錯誤 ResourceCountLimitExceededError.CAMPAIGN_LIMIT 預防方式 --
名稱長度	值 256 個字元 發生錯誤 StringLengthError.TOO_LONG 預防方式 --

Conversion upload
每次 API 呼叫可上傳的離線轉換上限	值 2,000 發生錯誤 ConversionUploadError.TOO_MANY_CONVERSIONS_IN_REQUEST 預防方式 基於成效考量，每個 API 要求可上傳的轉換數上限為 2,000 個。

Criterion
關鍵字長度	值 80 個字元 發生錯誤 CriterionError.KEYWORD_TEXT_TOO_LONG 預防方式 --
刊登位置網址長度	值 250 個字元 發生錯誤 CriterionError.PLACEMENT_URL_IS_TOO_LONG 預防方式 系統會從刊登位置網址中移除通訊協定前置字元 (例如「http://」)，因此不計入這個限制。
最終到達網址長度	值 2,047 個位元組 發生錯誤 StringLengthError.TOO_LONG 預防方式 通訊協定前置字元 (例如「http://」) 會計入這項限制。
鄰近半徑	值 800 公里 / 500 英里 發生錯誤 CriterionError.INVALID_PROXIMITY_RADIUS 預防方式 --
單一要求中的購物廣告群組數量上限，用於修改 ProductPartition 樹狀結構的結構。	值 2 發生錯誤 AdGroupCriterionError.OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS 預防方式 這項限制不適用於不會修改樹狀結構結構的 ProductPartition 條件變更。舉例來說，如果要求只修改現有分區的出價，可包含超過兩個購物廣告群組的作業。如果您要修改超過兩個購物廣告群組的 ProductPartition 樹狀結構結構，建議使用批次工作，但這項限制不適用。
每個廣告活動的排除 IP 封鎖數量上限	值 500 發生錯誤 ResourceCountLimitExceededError.CAMPAIGN_LIMIT 預防方式 --

Feed
每個帳戶的動態饋給	值 100 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 建議您盡可能讓每種額外資訊類型都只使用一則動態饋給。
每個帳戶的動態饋給項目	值 5,000,000 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 --
每個動態饋給的動態饋給屬性	值 30 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 --
每個比對函式的動態饋給項目	值 20 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 --

Label
單一管理員帳戶可套用到帳戶的標籤數量上限	值 200 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 --
可套用標籤的帳戶數量上限	值 1,000 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 --
每個帳戶可套用至實體的標籤數量上限	值 100,000 發生錯誤 ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc. 預防方式 所有實體類型的標籤都會計入相同的限制。
可套用至單一實體 (廣告活動、廣告群組等) 的標籤數量上限	值 50 發生錯誤 ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc. 預防方式 --

Listing groups
每個廣告群組的商家資訊群組數量上限	值 20,000 發生錯誤 ResourceCountLimitExceededError.RESOURCE_LIMIT 預防方式 --

Payments account
單一付款帳戶可連結的帳單設定數量上限	值 75,000 發生錯誤 BillingSetupError.PAYMENTS_ACCOUNT_INELIGIBLE 預防方式 --

Performance Max
帳戶中的最高成效廣告活動數量上限	值 100 發生錯誤 ResourceCountLimitExceededError.ACCOUNT_LIMIT 預防方式 詳情請參閱「帳戶上限」一文。如需提高上限，請與您的 Google 業務開發代表聯絡。
廣告活動中的素材資源群組數量上限	值 100 發生錯誤 ResourceCountLimitExceededError.RESOURCE_LIMIT 預防方式 --
素材資源群組中的商家資訊群組篩選器數量上限	值 1,000 發生錯誤 ResourceCountLimitExceededError.RESOURCE_LIMIT 預防方式 --
廣告活動中的商家資訊群組篩選器子產品群組數量上限	值 7 發生錯誤 AssetGroupListingGroupFilterError.TREE_TOO_DEEP 預防方式 --

在極少數情況下，即使您未超出上述任何限制，仍可能會收到 INTERNAL_ERROR。當內部資源受到管理，且依附元件超過內部限制時，就會發生這類情況。請嘗試縮減查詢的大小或複雜度。您可能需要執行多項查詢才能取得所需結果。