使用限制

用量限额有助于防止 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 次写入查询）。

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

• customBiddingAlgorithms.scripts.create
• customBiddingAlgorithms.uploadScript
• firstAndThirdPartyAudiences.create
• firstAndThirdPartyAudiences.editCustomerMatchMembers
• media.upload

超出配额限制

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

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

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

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