数以百万计的网站都在使用 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 minute
、Requests per minute per user
的配额。向任何以任何方式更改 Google Analytics(分析)帐号配置的方法(create
、patch
、delete
、archive
、update
方法)发出的请求也会消耗 Writes per minute
和 Writes per minute per user
配额。
如需了解如何按用户限制 API 请求,请参阅设置 API 用量上限一文。