API 请求的限制和配额

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

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

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

常规配额限制

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

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

管理 API

Google Analytics(分析)对这些管理 API 的请求应用配额:

写入 API

这些配额用于写(insertupdatepatchdelete)请求:

  • 每个项目的每日写入请求数为 500 次,该数量可增加
  • 每个帐号 ID 每秒查询 (QPS) 1.5 次

写入请求错误

如果写入请求失败,且收到响应代码 500503,则可以重新提交。Google Analytics(分析)允许:

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

如果您尝试每小时提交超过 50 次失败的写入请求,将收到以下错误:

Quota Error: The number of recent failed writes is too high.

不要持续重新提交失败的写入请求,请采用指数退避方式重新提交。

Data Import API

以下配额专门用于 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。

Experiments API

此配额仅适用于实验

  • 每个数据视图(配置文件)的实验数为 12 个

具有以下 statuses 之一的实验计入这个配额:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

已结束 (status = ENDED) 超过一天的实验不计入此配额。

Unsampled Reports API

这些配额仅适用于非抽样报告

  • 创建非抽样报告的 API 请求将计入常规写入请求配额。
  • 该 API 使用与通过网页界面创建非抽样报告时相同的每媒体资源、每一天令牌系统。
  • 允许的非抽样报告数量上限是 3,500。达到此限制时,尝试使用 API 创建更多非抽样报告会导致以下错误:
    Error creating this entity. You have reached the maximum allowed entities of this type.

User Permission API

此配额仅适用于用户权限

  • 一位用户最多可以有 100 个 Google Analytics(分析)帐号。将具有 100 个 Google Analytics(分析)帐号的用户添加到新帐号会导致错误。

以下配额适用于将deleteinsertupdate)请求批量写入用户权限:

  • 每批量请求有 300 个用户权限写请求
  • 30 个批量用户权限写入请求计为 1 次写入请求

超出配额限制

如果超出请求 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)都列在 Google API 控制台中的 Google Analytics(分析)API 内。

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