配额

配额可保护 Google 的基础架构免受自动化流程以不当方式使用 Google Bid Manager API 的影响。它们可以确保一个开发者的行为不会对更大的社区产生负面影响。

配额限制

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

  • 每个项目的每日请求数为 2,000 次 - 可增加
  • 每个项目的每秒查询数 (QPS) 为 4 次。
    • 在 Google API 控制台中,此配额称为每位用户每分钟的查询数,设为 240。

超出配额限制

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

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

编码 原因 消息 建议采取的措施
403 dailyLimitExceeded 已超出每日上限 在解决问题之前,请勿重试。通过 Google API 控制台检查您的使用情况,并修改您的工作流程以减少发送的请求数量。如果您认为自己的使用情况在合理范围内,则可以申请更多配额
403 userRateLimitExceeded 已超出用户速率限制 使用指数退避算法减缓您发送请求的速率。

申请更多每日配额

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

以下说明仅适用于遇到 dailyLimitExceeded 错误的项目。针对其他配额错误建议采取的操作已在上表中进行了介绍。

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

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