Search Ads 360 Reporting API 会对 API 操作施加限制,以确保所有用户都能获得最优的系统性能。
价格
Search Ads 360 Reporting API 的使用费包含在 Search Ads 360 总价中。使用 API 无需支付额外费用。
查询限制
以下限制适用于通过 Search 或 SearchStream 方法执行的查询操作。
- 每个用户每个项目每分钟 3000 次查询
- 每个项目每分钟 3000 次查询
- 每个项目每天 15 万次查询
API 的每天操作限制
API 的每日用量限额是根据每个 Google Cloud 项目执行的 API 操作次数计算的。
无论通过 SearchAds360Service.SearchStream
流式传输结果或通过 SearchAds360Service.Search
调用分页,一个查询或报告都计为一次操作。了解详情。
下表列举了一些示例来说明具体是如何计数的:
API 请求 | 计入每日限额的操作 |
---|---|
操作:Search
计数:53 个广告组
服务: |
1 |
操作:SearchStream
计数:45 个广告系列
服务: |
1 |
超出这些限制的请求会被拒绝,并显示以下错误:RESOURCE_EXHAUSTED
。
搜索请求
一个 Search
或 SearchStream
请求在用户的每日操作配额中计为一次操作。无论批次数量是多少,一个 SearchStream
请求都计为一个 API 操作。
gRPC 限制
所有 Search Ads 360 Reporting API 客户端库均使用 gRPC 生成请求和响应。默认情况下,gRPC 的消息大小为 4 MB。
回复数量不得超过此限制。例如,包含大量字段的搜索请求可能会生成大小超过 4 MB 的响应。若要避免此限制,您可以减少所选字段的数量、缩减页面大小或使用流式处理。
超出此限制的请求不会生成 SearchAds360Error
,但会生成 429 Resource Exhausted
gRPC 错误。请参阅 gRPC 错误代码和消息列表。
分页请求
分页请求(例如,包含有效 next_page_token
的请求)不计入用户的每日操作配额。但是,包含过期或无效页面令牌的分页请求将产生异常,并将计入每日操作配额。
分页请求(例如搜索请求)也要遵守 Page size cannot exceed 10,000 rows
限制,如果违反此限制,则请求将被拒绝,并显示以下错误:INVALID_PAGE_SIZE
。
如需详细了解分页,请参阅将结果分页。
返回 API 异常的请求
使用 SearchAds360Failure
拒绝的请求仍会计入用户的每日操作配额。
失败但未返回 SearchAds360Failure
的请求(例如由于网络级错误引起的请求)不会计入用户的日常操作配额,因为这些请求永远不会到达服务。例如,网络连接失败。
其他类型的限制
如果一个重复字段(例如操作列表)在请求中的项目过多,就可能会导致以下错误:REQUEST_SIZE_LIMIT_EXCEEDED
。此错误消息也可能是由其他问题导致的。
在进行 Search Ads 360 查询语言查询时,一个 IN
子句中的项目数上限为 20,000。如果超出该限制,系统会返回 FILTER_HAS_TOO_MANY_VALUES
错误。