系統限制

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

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

注意： 計算字串值的位元組限制時，系統會使用 UTF-8 編碼。

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。當內部資源進行對應時，如果有依附元件的分支超出內部限制，就會發生這種情況。請嘗試縮減查詢的大小或複雜度。您可能需要執行多個查詢才能取得所需結果。