价格、API 限制和配额

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

搜索请求

SearchSearchStream 请求计为一次操作,并计入用户的每天操作配额。无论批次数量是多少,一个 SearchStream 请求都算作一次 API 操作。

gRPC 限制

所有 Search Ads 360 报告 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 错误。