使用限制

用量限额有助于防止 Google 的基础架构以不当方式使用 Display & Video 360 API 的自动化流程。它们可确保单个开发者的行为不会对更广泛的社区产生负面影响。

API 请求配额限制

Display & Video 360 API 使用了两种类型的限制:

  • 总配额上限:所有相关请求都会计入上限。
  • 写入配额限制:向写入方法发出的所有相关请求都会计入这些限制。写入方法定义为修改资源的方法(如 createpatchdeletebulkEdit)。请注意,某些方法消耗的写入配额比其他方法更多。

如果您的项目超出其中任何一个限制,则可能会受到节流

项目级配额限制

所有 Display & Video 360 API 资源和方法均需遵循以下默认配额限制:

  • 每个项目每分钟的总请求数1500
  • 每个项目每分钟的写入请求数700

特定于广告客户的请求配额限制

在请求网址中指定广告客户 ID 的方法将计入额外的“每个项目每广告客户”配额限制。

网址路径中指定广告客户 ID 的所有请求(例如向 advertisers.lineItemsadvertisers.creativesadvertisers.channels 服务发出的请求)将计入以下配额限制:

  • 每个项目中每个广告客户每分钟的请求总数300
  • 每个项目每位广告客户每分钟的写入请求数150

写入密集型方法

以下 API 方法属于写入密集型方法,这意味着它们会使用大量的产品资源,因此会比其他写入请求消耗更多的写入请求配额。

在计算写入请求配额消耗量时,向写入密集型方法发出的请求计为 5 次写入查询。例如,一分钟内发出的 100 个标准写入请求和 21 个写入密集型请求(均不指定广告客户)将计为 205 次写入查询 (100 + (21 * 5) = 205),并且会超出现有的常规请求配额限制(即每分钟 200 次写入查询)。

以下方法被视为写入密集型方法:

超出配额限制

在极少数情况下,如果您的请求因超出 API 请求限制而失败,则 API 会返回 HTTP 状态代码和错误原因。此外,响应正文还将详细说明出错的原因。

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

代码 RPC 消息 建议采取的措施
429 RESOURCE_EXHAUSTED 资源已用尽(如查看配额)。 通过 Google API 控制台检查您的使用情况,并修改您的工作流程,以便更好地并行处理不同广告客户下发出的请求,或者降低发送请求的速度。

无法申请提高 Display & Video 360 API 配额限制。