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 请求（例如，代表用户发出请求），请在每个请求中使用 userIP 或 quotaUser 参数，以便为每个用户获取完整的 QPS 配额。如需了解详情，请参阅标准查询参数摘要。

某些 API 还存在其他限制。如需详细了解特定于 API 的限制和配额，请参阅以下页面：

与限制和配额相关的错误

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

如需详细了解配额管理以及如何优化应用以控制配额用量，请参阅监控 API 和限制用量。