Search Ads 360 Reporting API 对 API 操作施加了限制，以确保所有用户都能获得最佳系统性能。
价格
Search Ads 360 Reporting API 的使用费用包含在 Search Ads 360 的整体价格中。使用该 API 无需支付额外费用。
查询限制
以下限制适用于通过 Search 或 SearchStream 方法执行的查询操作。
- 每个项目每位用户每分钟 3,000 次查询
- 每个项目每分钟 3,000 次查询
- 每个项目每天 150,000 次查询
API 的每天操作限制
API 的每天使用限制是根据每个 Google Cloud 项目执行的 API 操作数量确定的。
无论结果
是通过
SearchAds360Service.SearchStream
进行流式传输，还是通过
SearchAds360Service.Search
调用进行分页，单个查询或报告都算作一次操作。了解详情。
下表列举了一些示例来说明具体是如何计数的：
| API 请求 | 计入每日上限的操作 |
|---|---|
操作：Search
计数：53 个广告组 服务： SearchAds360Service
|
1 |
操作：SearchStream
计数：45 个广告系列 服务： SearchAds360Service
|
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
错误。