系統限制

本頁列出 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。當內部資源受到管理,且依附元件超過內部限制時,就會發生這類情況。請嘗試縮減查詢的大小或複雜度。您可能需要執行多項查詢才能取得所需結果。