API 请求的限制和配额

我们对 API 请求设置了限制和配额,以防止系统收到的数据量超出其处理能力,并确保公平分配系统资源。这些限制和配额随时可能发生变化。

速率限制

API 速率限制定义了可向 Google Marketing Platform Admin API 发出的请求数。速率限制是强制执行的,并且每隔 60 秒(1 分钟)自动重新填充。也就是说,如果您的项目在 60 秒内达到速率上限,则需要等待配额重新填充,然后才能在该组中发出更多请求。如果您的项目超过速率限制,您会收到 403 错误和原因 rateLimitExceeded。如需解决此错误,请等待一分钟再重新发送请求,配额应该会在下一个间隔开始时重新填充。

每日 API 请求次数上限自然受到 API 速率限制的约束,目前 Google Marketing Platform Admin API 没有明确的每日用量配额。

Cloud 项目配额

API 速率限制按项目计算。

Cloud 控制台会显示 Cloud 项目的配额:https://console.cloud.google.com/apis/api/marketingplatformadmin.googleapis.com/quotas

以下是 Google Marketing Platform Admin API 的默认配额,大多数用户会在其控制台中看到这些配额。

配额名称 限制
每分钟请求数 1200
每位用户每分钟的请求数 600
每分钟写入次数 300
每位用户每分钟的写入次数 120

对 Google Marketing Platform Admin API 的每次请求都会消耗 Requests per minuteRequests per minute per user 配额。对以任何方式更改 Google Marketing Platform 账号配置的任何方法(createpatchdeletearchiveupdate 方法)的请求也会消耗 Writes per minuteWrites per minute per user 配额。

如需了解如何按用户限制 API 请求,请参阅限制 API 用量一文。