配额

每个 API 请求都会验证配额是否未用尽并消耗配额。如有任何配额已用尽,请求将失败并显示相关的错误消息。每个 Data API 请求会检查几个配额桶。

配额类别

就配额而言,Data API 有三个请求类别:核心请求、实时请求和漏斗请求。向核心方法发出的 API 请求会计入核心配额。对 Realtime 方法的 API 请求会收取实时配额的费用。一个请求不会同时占用核心配额和实时配额。以下是 API 方法和类别:

配额类别 API 方法
Core runReportrunPivotReportbatchRunReportsbatchRunPivotReportsrunAccessReportgetMetadatacheckCompatibilitycreateAudienceExports
实时 runRealtimeReport
漏斗图 runFunnelReport

Google Analytics(分析)媒体资源配额

所有请求都会消耗媒体资源配额。

配额名称 标准媒体资源限制 Analytics 360 媒体资源数量上限
每项媒体资源每天的核心令牌数 200000 200 万
每项媒体资源每小时的核心令牌数 40000 400000
每个项目每项媒体资源每小时的核心令牌数 14000 140,000
每个媒体资源的核心并发请求数 10 50
每个项目每项媒体资源每小时的核心服务器错误数 10 50
每项媒体资源每天的实时令牌数 200000 200 万
每项媒体资源每小时的实时令牌数 40000 400000
每个项目每项媒体资源每小时的实时令牌数 14000 140,000
每个媒体资源的实时并发请求数 10 50
每个项目每项媒体资源每小时的实时服务器错误数 10 50
每项媒体资源每天的漏斗令牌数 200000 200 万
每项媒体资源每小时的漏斗令牌数 40000 400000
每个项目每项媒体资源每小时的漏斗令牌数 14000 140,000
漏斗并发请求数(每项媒体资源) 10 50
每个项目每项媒体资源每小时的漏斗服务器错误数 10 50
  • 并发请求按同时执行的请求数量进行衡量。如需减少请求并发数,请等待之前的请求完成,然后再发送其他请求。
  • 服务器错误由 500 和 503 代码组成。仅当请求中包含“服务器错误”时,我们才会对“服务器错误”配额收费。当某个项目和媒体资源对的“服务器错误”配额用尽时,系统会屏蔽该项目对相应媒体资源的所有请求。
  • 每次请求消耗“每项媒体资源每小时的令牌数”和“每个项目每项媒体资源每小时的令牌数”配额。这意味着,一个媒体资源必须有 3 个以上的项目访问,否则“每个媒体资源每小时的令牌数”配额可能在“每个项目每项媒体资源每小时的令牌数”配额之前用尽。

媒体资源每小时可处理 120 个可能设置了阈值的请求。维度 userAgeBracketuserGenderbrandingInterestaudienceIdaudienceName 可能会受到限制。我们应用阈值,是为了防止查看报告的人推断出个别用户的受众特征或兴趣。

属性令牌配额

每个请求都会根据完成请求的复杂程度计算令牌。大多数请求会收取 10 个或更少的令牌。当某个请求消耗大量配额令牌时,通常由以下因素导致:

  • 行数很多
  • 列数很多
  • 复杂的过滤条件
  • 日期范围较长

对于每个 API 请求,您可以在请求正文中指定 "returnPropertyQuota": true,以返回当前的媒体资源配额令牌状态。此状态包含此请求消耗的用量以及每个配额组的剩余数量。例如,可考虑在 RunReportRequest 中指定此参数。