限制

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