API 请求的限制和配额

数以百万计的网站都在使用 Google Analytics(分析)。我们对 API 请求设置了限制和配额,以防止系统收到的数据量超出其处理能力,并确保公平分配系统资源。限额和配额随时可能更改。

速率限制

API 速率限制定义了可向 Google Analytics(分析)Admin API 发出的请求数。系统将强制执行速率限制,并以 60 秒(1 分钟)为间隔自动重新填充流量。这意味着,如果您的项目在 60 秒内随时达到速率限制上限,则您需要等待该配额重新补充,然后才能在该组中发出更多请求。如果您的项目超过速率限制,您会收到 403 错误,原因为 rateLimitExceeded。如需解决此错误,请等待一分钟,然后重试您的请求;配额应该会在下一个时间间隔开始时重新补充。

每日 API 请求次数上限自然受到 API 速率限制,目前 Google Analytics(分析)Admin API 目前没有明确的每日使用配额。

Cloud 项目配额

API 速率限制按项目计算。

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

以下是大多数用户在控制台中看到的 Google Analytics(分析)Admin API 的默认配额。请注意,对于违反 Google Analytics(分析)服务条款的项目,系统可能会自动限制配额限制。

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

对 Google Analytics(分析)Admin API 的每个请求都会消耗 Requests per minuteRequests per minute per user 的配额。向任何以任何方式更改 Google Analytics(分析)帐号配置的方法(createpatchdeletearchiveupdate 方法)发出的请求也会消耗 Writes per minuteWrites per minute per user 配额。

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