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 minute、Requests per minute per user 配额。对以任何方式更改 Google Marketing Platform 账号配置的任何方法(create、patch、delete、archive、update 方法)的请求也会消耗 Writes per minute 和 Writes per minute per user 配额。

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