每个 API 请求都会验证配额是否未用尽并消耗配额。如有任何配额已用尽,请求将失败并显示相关的错误消息。每个 Data API 请求会检查几个配额桶。
配额类别
就配额而言,Data API 有三个请求类别:核心请求、实时请求和漏斗请求。向核心方法发出的 API 请求会计入核心配额。对 Realtime 方法的 API 请求会收取实时配额的费用。一个请求不会同时占用核心配额和实时配额。以下是 API 方法和类别:
配额类别 | API 方法 |
---|---|
Core | runReport、runPivotReport、batchRunReports、batchRunPivotReports、runAccessReport、getMetadata、checkCompatibility、createAudienceExports |
实时 | 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 个可能设置了阈值的请求。维度 userAgeBracket
、userGender
、brandingInterest
、audienceId
和 audienceName
可能会受到限制。我们应用阈值,是为了防止查看报告的人推断出个别用户的受众特征或兴趣。
属性令牌配额
每个请求都会根据完成请求的复杂程度计算令牌。大多数请求会收取 10 个或更少的令牌。当某个请求消耗大量配额令牌时,通常由以下因素导致:
- 行数很多
- 列数很多
- 复杂的过滤条件
- 日期范围较长
对于每个 API 请求,您可以在请求正文中指定 "returnPropertyQuota": true
,以返回当前的媒体资源配额令牌状态。此状态包含此请求消耗的用量以及每个配额组的剩余数量。例如,可考虑在 RunReportRequest 中指定此参数。