使用限制

使用限制可保护 Google 的基础架构免受自动流程以不当方式使用 Display & Video 360 API 所造成的影响。它们可确保一个开发者的行为所造成的负面影响不会波及更大范围的开发者群体。

API 请求配额限制

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

  • 总配额限制，所有相关请求都会计入其中。
  • 写入配额限制，向写入方法发出的所有相关请求都会计入此配额。写入方法定义为用于修改资源的方法，例如 create、patch、delete 或 bulkEdit。请注意，某些方法会比其他方法消耗更多写入配额。

如果您的项目超出其中任何一项限制，可能会出现节流。

项目级配额限制

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

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

针对广告客户的请求配额限制

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

所有在网址路径中指定了广告客户 ID 的请求（例如对 advertisers.lineItems、advertisers.creatives 或 advertisers.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 配额限制。