API 限制和配额

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

概览

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

针对在 API 间共享的常规 Google Analytics(分析)API 配额以及具体用于管理 API 或报告 API 的配额,此视频讨论了最佳做法。

常规配额限制

以下配额限制在 Management APICore Reporting API V3MCF Reporting APIMetadata APIReal Time Reporting API 间共享。

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

Management API

写请求次数

此配额适用于写(如 insertupdatepatchdelete)请求:

  • 每个项目的每日写请求数为 500 次,该数量可增加

写请求错误

实现指数退避时,如果您得到 500503 响应,可以重试。此配额适用于失败的写请求:

  • 每小时 50 次失败的写请求。

数据导入

以下配额专门用于 Uploads 资源:

  • 生命周期扩展数据导入的存储限制(不适用于从数据收集 API 和 SDK 发送的匹配数据)。
    • 处理时间导入模式的 Analytics 360 限制:
      • 每个媒体资源 1 TB。
      • 每个数据集 20 GB。
    • 查询时间导入模式的 Analytics 360 限制。
      • 每个媒体资源 1 GB。
      • 每个数据集 1 GB。
    • 标准限制:
      • 每个媒体资源 10 GB。
      • 每个数据集 10 GB。
  • 每个媒体资源的数据集数量为 50 个。
  • 每个媒体资源的每日上传操作次数为 50 次。
  • 每个上传的文件 1 GB。
  • 专门针对费用数据的限制:
    • 每个数据集的单日 (ga:date) 大小为 100 MB。例如,如果您在 2014 年 10 月 10 日的一次上传操作中上传了 50 MB 的数据,然后在当日的另一次上传操作中又上传了 50 MB 的数据,那么您就达到了该数据集在 2014 年 10 月 10 日的上限:100 MB。

实验

以下配额专门用于实验

  • 每个数据视图(配置文件)的实验数为 12 个。处于以下 status 的实验将计入此限额:DRAFTREADY_TO_RUNRUNNING。处于 ENDED 状态超过一天的实验不计入此限额。

非抽样报告

以下配额专门用于非抽样报告

用户权限

以下配额专门用于用户权限

  • 每个用户的关联帐号数为 100 个。

这些限制适用于用户权限的批量写(deleteinsertupdate)请求

  • 每个批量请求的用户权限请求数量限制为 300 次。
  • 30 个批量发送的用户权限请求计为 1 次写入请求

Provisioning API

写请求次数

以下配额适用于 Provisioning API 的写请求(比如 createAccountTicket):

  • 每个项目的每日请求数为 50 次。

报告 API

这些配额适用于所有报告 API,包括 Core Reporting APIRealtime APIMulti-channel Funnel API V3Analytics Reporting API V4

  • 每个数据视图(配置文件)的每日请求数为 10000 次。
  • 每个数据视图(配置文件)的并行请求数为 10 次。

报告错误

此配额适用于失败的 (5XX) 报告请求:

  • 每小时每个配置文件每个项目 10 次失败的请求。
  • 每天每个配置文件每个项目 50 次失败的请求。

超出配额限制

如果超出配额,Google Analytics(分析)API 将针对超额请求返回错误 (HTTP status code 403 Forbidden)(HTTP 状态代码 403 禁止访问),并显示一条消息,指明相应帐户的配额不足,无法继续操作。有关详情,请参阅服务条款

请求更多配额

您只能请求提高每日的项目请求次数每日的写请求次数这两类配额。如果您认为自己的应用需要更多每日配额,可以按照以下说明进行申请。

要查看或更改项目的使用限额,或请求增加配额,请按以下步骤操作:

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

在提交配额增加请求之前,请务必查看信息,并遵从配额请求表单中的说明。对于 Reporting API V4,在 Developers Console 中的 API 名称是 Analytics Reporting API V4。所有其他 V3 API(如 Management API V3、Core Reporting API V3、Real Time Reporting API V3)在 Developers Console 中都列在单一 API 名称 Analytics API 下。

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