系统限制

本页列出了 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

每个账号的 Feed 数量上限
100
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 我们建议您尽可能为每种扩展程序类型使用一个 Feed。
每个账号的 Feed 项数量上限
5,000,000
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --
每个 Feed 的 Feed 属性数量上限
30
错误 ResourceCountLimitExceededError.ACCOUNT_LIMIT
预防 --
每个匹配函数的 Feed 项数量上限
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。当内部资源被序列化且依赖项扇出超出内部限制时,就会发生这种情况。请尝试缩减查询的大小或复杂性。您可能需要执行多个查询才能获得所需结果。