API 请求的限制和配额

本文介绍了请求管理 API 和报告 API 的限制和配额。

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

此视频讨论了管理 Google Analytics(分析)API 请求配额的最佳做法。

常规配额限制

以下配额适用于 Management APICore Reporting API v3MCF Reporting APIMetadata APIUser Deletion APIReal Time Reporting API

  • 每个项目的每日请求数为 50000 次,该数量可增加
  • 每个 IP 地址的每秒查询数 (QPS) 为 10 次。
    • API 控制台中,有一个称为每用户每 100 秒请求数的类似配额。此配额默认设置为每用户每 100 秒 100 次请求,最大值可调整为 1000。但是,API 的请求数量限制为每用户每秒最多 10 次请求。
    • 如果您的应用从单个 IP 地址(即代表您的用户)发出所有 API 请求,请为每个请求使用 userIPquotaUser 参数,以获取每个用户的完整 QPS 配额。如需了解详情,请参阅标准查询参数摘要

Reporting APIs

以下配额适用于所有报告 API,包括 Core Reporting API v3Analytics Reporting API v4Real Time API v3Multi-channel Funnel API v3

  • 每个数据视图(配置文件)的每日请求数为 1 万次(无法增加)
  • 每个数据视图(配置文件)的并行请求数为 10 次(无法增加)

报告 API 请求错误

如果您对 Reporting API 的请求因服务器错误而失败,您会收到响应代码 500503。您可以重新提交该请求;但是,如果请求多次失败,请勿多次重新提交。Google Analytics(分析)允许:

  • 每小时每个数据视图(配置文件)每个项目 10 次服务器错误失败请求
  • 每个数据视图(配置文件)的每日每个项目 50 次服务器错误请求失败

如果失败的请求数量超过这些配额,您将收到以下错误:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

要缩短请求服务器出错的可能性,请缩小日期范围、减少请求中的维度数量或减少请求中的指标数量,从而简化请求。

请勿不断重新提交失败的请求。而应使用指数退避算法重新提交。

系统会针对每小时和每日错误率配额,在滚动的时间范围内强制执行服务器错误率配额。在项目和视图对中的第一个服务器错误发生一小时后,配额会重置。如果项目和视图对在一小时内发送 10 个服务器错误,在第一个服务器错误过去一小时后,API 将阻止项目和视图对。

例如,如果项目和视图对在过去 24 小时内未发送服务器错误,此项目和视图已使用其 50 个配额中的 0。假设此项目和视图现在在早上 6:12 发送服务器错误。如果此项目和视图在次日早上 6:12 之前发送另外 49 个服务器错误,此项目和视图将被阻止直到次日早上 6:12。在次日早上 6:12,此项目和视图的服务器错误率配额将完全重置。

Analytics Reporting API v4

这些配额仅适用于 Analytics Reporting API v4

  • 每项目每天请求数:5 万次
  • 每个数据视图(配置文件)的每日请求数:1 万次(无法增加)
  • 每项目每 100 秒请求数:2,000 次
  • 每个项目每用户每 100 秒的请求数:100(可在 Google API 控制台中增加到 1000)。

您可以在 Google API 控制台中查看项目的配额。

基于资源的配额

Analytics Reporting API v4 也要遵守可选的基于资源的配额限制,这种配额允许 Analytics 360 客户使用较高的抽样阈值。

超出配额限制

如果超出请求 Google Analytics(分析)API 的配额,API 会返回错误代码 403429 以及显示该帐号已超出配额的消息。如需了解详情,请参阅服务条款

申请更多配额

您只能申请增加:

如需查看或更改项目的用量限额,或申请增加配额,请执行以下操作:

  1. 如果您的项目还没有结算帐号,请创建一个。
  2. 在 API 控制台中访问 API 库中的“已启用的 API”页面,然后从列表中选择一个 API。
  3. 如需查看和更改配额相关设置,请选择配额。如需查看使用量统计信息,请选择使用量

如需申请增加配额上限,请使用 Google Analytics(分析)API 配额申请表单。 在提交申请之前,请务必查看相关信息,并按照配额申请表单中的说明操作。对于 Reporting API v4,Google API 控制台中的 API 名称为 Google Analytics(分析)Reporting API。所有其他 v3 API(例如,Management API v3、Core Reporting API v3、Real Time Reporting API v3、User Deletion API v3)列在 Google API 控制台中的 Analytics API 下。

要详细了解配额管理以及如何调整应用的配额使用,请参阅监控 API 和设置使用上限