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 次请求,最大值可调整为 1,000 次。但是,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,此项目和视图的服务器错误率配额将完全重置。

超出配额限制

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