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 配额。有关详情,请参阅标准查询参数摘要

Reporting APIs

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

  • 每个数据视图(配置文件)的每日请求数为 1 万次(无法增加)
  • 每个数据视图(配置文件)的并行请求数为 10 次(无法增加)
Google Analytics(分析)Real Time Reporting API 调用与其他 Google Analytics(分析)API 是分开统计的,这意味着,使用 Google Analytics(分析)Real Time Reporting API 时,每个数据视图(配置文件)每天可以发出 1 万次调用;或者,可以使用任何其他 Google Analytics(分析)API 针对每个数据视图(配置文件)每天再进行 1 万次调用。

此行为提供了一种更精细且支持故障安全的配额管理方法,因此在使用 Google Analytics(分析)Real Time Reporting API 进行频繁调用时,不会在当天剩余时间内意外阻止单个数据视图(配置文件)的所有其他 Google Analytics(分析)API 调用。

报告 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,此项目和视图的服务器错误率配额将完全重置。

超出配额限制

如果超出请求 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 和设置使用上限