系统限制

本页列出了 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
预防 参见上文。
最终到达网址长度
2084 字节
错误 StringLengthError.TOO_LONG
预防 最终到达网址必须使用协议前缀(例如“https://”),因此会计入此限制。

Ad group

名称长度
256 个字符
错误 AdGroupError.INVALID_ADGROUP_NAME
预防 --

Campaign budget

一个账号中的共享预算数量上限
11000
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 预算限制比广告系列数量限制多 1,000,从而留出一些空间来重新分配预算(如果需要的话)。可共享预算的广告系列数量不受限制。
一个账号中的非共享预算数量上限
20000
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 这些预算与特定广告系列相关联,不能在广告系列之间共享。

Campaign

每个广告系列的广告组附加出价策略数量上限
1,000
错误 ResourceCountLimitExceededError.CAMPAIGN_LIMIT
预防 --
名称长度
256 个字符
错误 StringLengthError.TOO_LONG
预防 --

Conversion upload

每次 API 调用可上传的线下转化点击转化次数上限
2000
错误 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

每个帐号的 Feed 数量上限
100
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 我们建议您尽可能只为每种附加信息类型使用一个 Feed。
每个帐号的 Feed 项数量上限
500 万
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --
每个 Feed 的 Feed 属性数量上限
30
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --
每个匹配函数的 Feed 项数量上限
20 个
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --

Label

经理帐号可向帐号应用的标签数量上限
200
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --
单个标签可以应用到的帐号数量上限
1,000
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --
每个账号中可应用于实体(广告系列、广告组等)的标签数量上限
10 万
错误 ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc.
预防 所有实体类型的标签均计入相同的限制。
可应用于单个实体(广告系列、广告组等)的标签数量上限
50 个
错误 ResourceCountLimitExceededError.CAMPAIGN_LIMIT, ADGROUP_LIMIT, etc.
预防 --

Listing groups

每个广告组的产品信息组数量上限
20000
错误 ResourceCountLimitExceededError.RESOURCE_LIMIT
预防 --

Payments account

一个付款账号可以关联的结算设置数上限
75000
错误 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。如果内部资源已封送处理,并且依赖项的扇出超出内部限制,就会发生这种情况。请尝试减少查询的大小或复杂程度。您可能需要执行多个查询才能获得所需的结果。