配额

配额可保护 Google 的基础设施免受自动流程以不当方式使用 Campaign Manager 360 API 所造成的影响。它们可确保一个开发者的行为所造成的负面影响不会波及更大范围的开发者群体。

配额限制

所有 Campaign Manager 360 API 资源和方法均需遵循下列默认配额限制。

  • 每个项目的每日请求数为 50000 次 - 可提高
  • 每个项目的每秒查询数 (QPS) 为 1 次。
    • 在 Google API 控制台中,此配额称为每个用户每 100 秒查询数,默认设为 100 次。此限制可根据需要提高,最多可提高至 1000 次 (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. 如果使用情况看似正常,请转到配额页面,点击每日查询量旁边的修改图标,然后点击“申请更高配额”链接。

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