基于资源的配额

本文档说明了 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. 要查看和更改配额相关设置,请选择配额。要查看使用情况统计信息,请选择使用情况