本页面列出了针对 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 错误。