系統限制

本頁列出 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 預防方式 如上所示。
路徑 1 或路徑 2 長度	價值 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。如果內部資源受到編組，且依附元件的擴散傳遞超過內部限制，就會發生這種情況。請嘗試縮減查詢的大小或複雜度。您可能需要執行多項查詢，才能取得所需結果。