配额

配额可保护 Google 的基础架构免受自动流程以不当方式使用 Campaign Manager 360 API 所造成的影响。它们可确保开发者的操作 不会对整个社区产生负面影响。

配额限制

所有 Campaign Manager 360 API 资源均需共用以下默认配额限制 和方法。

  • 每个项目的每日请求数为 50,000 次 - 可提高
  • 每个项目的每秒查询数 (QPS) 为 1 次。
    • 在 Google API 控制台中,此配额称为查询/ 分钟,默认设为 60。此限制可酌情提高,最多可提高至 600 次 (10 QPS)。

报表制作工具会强制实施额外的配额限制,具体因账号而异。如需了解详情,请参阅这篇帮助中心文章和下表。

超出配额限制

在极少数情况下,您的请求会因为超出配额限制而失败 该 API 将返回 HTTP 状态代码和错误原因。此外,响应正文还将详细说明出错的原因。 如需查看错误响应示例,请参阅错误消息指南。

下表列出了因超出配额限制而导致请求失败时可能出现的错误,以及建议采取的措施。

代码 原因 消息 建议采取的措施
403 dailyLimitExceeded 超出每日上限 在解决问题之前,请勿重试。通过 Google API 控制台检查您的使用情况,并修改您的工作流程以减少发送的请求数。如果您认为自己的使用情况在合理范围内,则可以申请更多配额
403 quotaExceeded 此账号已超过每天 x 份报表的配额。 这一天请勿再针对此账号生成任何报表。请与您的客户经理联系,以获取帮助。
403 quotaExceeded 此用户个人资料已超过其每天 x 份报表的配额。 这一天请勿再针对此用户个人资料生成任何报表。请切换到其他用户个人资料或与您的客户经理联系,以获取帮助。
403 quotaExceeded 此账号已超过其 x 份有效定期报表的配额。 请先停用不需要的定期报表,然后再重试此请求。
403 quotaExceeded 此报表所属的用户个人资料已超过其 x 份有效定期报表的配额。 请此报告的所有者停用不需要的定期生成的报告,然后再重试此请求。
403 quotaExceeded 此用户个人资料已超过其 x 份有效定期报表的配额。 请先停用不需要的定期生成的报表,然后再重试此请求。
403 quotaExceeded 无法完成此操作,因为已经超出您的某项配额。请与您的客户经理联系寻求帮助。 请与您的客户经理联系,以获取帮助。
403 userRateLimitExceeded 已超出用户速率限制 在 Google API 控制台中提高每位用户限制,或使用指数退避算法减缓您发送请求的速率。不建议使用此 API 发出并发写入请求或采用高于 10 QPS 的速率限制。

申请更多每日配额

如果您认为自己的应用需要更多每日配额,您可以 按照以下说明提交更多请求。

以下说明仅适用于遇到 dailyLimitExceeded 错误的项目。对于其他配额错误,上表中已介绍了建议采取的措施。

  1. 前往 Google API 控制台中的 Campaign Manager 360 API
  2. 指标页面查看您的使用情况统计信息,确保您的 应用是否按预期运行。请密切关注 并解决之前的任何意外或过度使用问题, 继续进行。
  3. 如果使用情况看似正常,请转到配额页面,点击每日查询量旁边的修改图标,然后点击“申请更高配额”链接。

在提交提高配额的申请之前,请务必仔细查看相关信息,并按照配额申请表单中的说明操作。