限制

本页面列出了针对 AdSense Management API 的各种配额和限制。除了适用于 AdSense 的一般产品特定限制(例如每个账号的频道数量限制)外,还须遵守这些限制条件。

API 级配额

发送到 AdSense Management API 的所有请求都会计入常规请求速率配额,与请求类型无关。

您可以在 Google API 控制台中的配额页面查看这些配额的当前用量。您还可以设置用量提醒或额外的监控;如需了解详情,请参阅常规 Google Cloud 配额概览文档

超过这些配额将导致请求被拒绝,并出现 HTTP 429 Too Many Requests 错误。错误消息中会提供超出配额的详细信息。

说明 价值 备注
单个用户和项目的每分钟查询次数 100 不适用
使用单个项目的所有用户的每分钟查询次数 500 不适用
每天查询次数 10000 每日配额会在美国太平洋时间零点重置。

报告大小限制

AdSense Management API 生成的报告具有大小上限,具体取决于输出格式:

  • JSON 报告(例如,由 accounts.reports.generate 方法生成)最多只能包含 10 万行。大于此值的报告将被截断,但响应中包含 totalMatchedRows 字段,其中包含完整报告的大小,可用于确定是否发生了截断。
  • CSV 报告(例如由 accounts.reports.generateCsv 方法生成的报告)最多可包含 100 万行。超过此值的报告将会被截断。

报告行配额

为防止滥用,AdSense Management API 还对每天和较短时间段内可检索到的报告数据总量施加了限制。超出这些限制会导致请求被拒绝,并显示 HTTP 429 Too Many Requests 错误,以及关联的消息“Report row quota out”(报告行配额已超出)。

其他请求限制

各种请求参数用于控制应为一个请求返回的数据量(例如,page_size 表示允许分页的请求,limit 参数则表示报告生成请求)。如果未指定这些参数,则默认值始终是允许的最大值。指定更高的值会导致请求被拒绝,并出现 HTTP 400 Bad Request 错误。