基于资源的配额

本文档说明了 Google Analytics(分析)Reporting API v4 的基于资源的配额系统,该系统仅适用于 Analytics 360 客户。有关适用于这些 API 的所有限制,请查看 API 限制和配额

简介

为确保共享资源的可用性和可靠性,每个访问 Google Analytics(分析)Reporting API 的项目都需要遵守相关的限制和配额。查询大型数据集时,Google Analytics(分析)Reporting API 可能会采用抽样方式,这可能会影响数据结果。

基于资源的配额系统是一种新的配额系统,可让 Analytics 360 帐号在使用 Analytics Reporting API 时具有更高的抽样阈值。此系统是可选的,并且与对视图和项目的现有限制(例如在 Google API 控制台的配额页面中报告的限制)无关。

基于资源的配额

并非所有创建的请求都相同;一些请求消耗的计算资源远远高于其他请求。采用基于资源的配额系统的目的是支持更高的抽样阈值,同时保护 Google Analytics(分析)报告基础架构。

系统会为每个媒体资源分配一定数量的查询资源令牌。API 客户端可以向 API 请求添加可选字段,以获取更高的采样阈值,以换取相对查询资源令牌。计算开销较高的请求需要更多令牌。

抽样阈值

如果使用 Google Analytics(分析)API v4 请求数据,那么根据请求日期范围内的会话数量(在媒体资源级别),要受以下一般抽样阈值的限制:

  • Google Analytics(分析)标准版:50 万次会话
  • Analytics 360:100 万次会话
  • Analytics 360 使用基于资源的配额:1 亿次会话

启用基于资源的配额

如需为给定请求启用基于资源的配额,API 调用必须在 batchGet 方法中包含可选字段 useResourceQuotas

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

例如:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

查询资源成本响应字段

每次调用 batchGet 方法时,响应中都将有一个 queryCost 字段。

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

queryCost 字段是一个整数,表示 batchGet 请求中所有 ReportRequests 的总资源费用。例如:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

配额的分配方式

Analytics 360 媒体资源配额

  • 每个媒体资源每天 100,000 个查询成本单位。
  • 每个媒体资源每小时 25,000 个查询成本单位。

如果超过配额限制,您将收到 RESOURCE_EXHAUSTED 错误。如需了解详情,请参阅错误响应

成本计算

请求的成本与以下数据成正比:

  • 日期范围的大小。
  • 数据视图内的匹配次数。
  • 请求维度的基数。
  • 请求的维度和指标的数量。
  • 细分和过滤器定义的复杂性。
  • 请求信息的处理状态(请求今天数据的成本高于请求昨天数据的成本)。
  • 是否存在查询时导入维度和指标。

API 限制和使用

除了基于资源的配额系统之外,API 还需遵守 Google Analytics(分析)API v4 中的限制和配额规定。

备注

  • queryCost 响应字段表示请求的计算开销。这不是货币成本,且该 API 是免费使用的。
  • 无论 useResourceQuotas 设置为何,当日数据和某些历史数据(1 年以上)的报告可能仍会进行抽样。
  • 如果无法满足某个请求的较高抽样阈值,则不会扣除资源配额令牌(即抽样响应的资源配额成本始终为零)。
  • 如果响应中包含 samplesReadCountssamplingSpaceSizes 字段,则报告包含抽样数据。

如需查看或更改项目的用量限额,或申请增加配额,请执行以下操作:

  1. 如果您的项目还没有结算账号,请创建一个。
  2. 在 API 控制台中访问 API 库中的“已启用的 API”页面,然后从列表中选择一个 API。
  3. 如需查看和更改配额相关设置,请选择配额。如需查看用量统计信息,请选择使用量