API 请求的限制和配额

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

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

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

常规配额限制

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

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

Management API

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

写入 API

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

  • 每个项目的每日写入请求数为 50 次,该数量可增加
  • 每个账号 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、User Deletion API v3)列于 Google API 控制台的 Google Analytics(分析)API 下。

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