API 请求的限制和配额

为确保 Google Analytics 系统收到的数据量不会超出其处理能力,并确保在用户之间公平分配系统资源,Google Analytics API 对您的使用情况施加了一些限制和配额。

以下限制和配额适用于 Google Cloud 项目级 Google Analytics API 的总体使用情况(不包括 Data API 调用):

  • 每个项目每日的请求数不得超过 50,000 次。
  • 每个 IP 地址的每秒查询次数 (QPS) 不得超过 10 次。
    • API 控制台中,有一个类似的配额,称为每个用户每 100 秒请求数。默认情况下,此配额设置为每个用户每 100 秒 100 个请求,最高可调整为 1,000 个。不过,向该 API 发出的请求数限制为每位用户每秒最多 10 个请求。
    • 如果您的应用通过单个 IP 地址(例如代表用户)发出所有 API 请求,请在每个请求中使用 userIpquotaUser 参数,以便为每个用户获取完整的 QPS 配额。

部分 API 存在额外限制。如需详细了解特定于 API 的限制和配额,请参阅以下页面:

与限制和配额相关的错误

如果已超出 Google Analytics API 请求的配额,则该 API 将返回错误代码 403429 以及账号已超出配额的消息。如需了解详情,请参阅服务条款

如需详细了解配额管理以及如何针对配额用量对应用进行微调,请参阅监控 API 和限制用量