查询指标集

设置完所有内容后，您可以向 Google Play Developer Reporting API 发送请求，以检索有关指标集的元数据并查询其指标。

以下代码示例演示了如何发送一些简单的请求。例如，以下方法展示了如何检索应用的各种指标。您可以使用一些不同的查询参数来缩小查询范围。

检索指标集元数据

以下示例检索了虚构应用 com.example.app 的崩溃率指标集的元数据。

简单请求：

此 HTTP GET 请求指定了应用名称参数，并返回与您的应用关联的完整指标资源。 

GET https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet

指标信息响应：

响应包含与指标集相关的以下字段： 

{
  "freshness_info": {
    "freshness": [
      "aggregation_period": "DAILY"
      "latest_end_time": { year: "2021" month: "7" day: "22" time_zone: "America/Los_Angeles" }
    ]
  }
}

使用查询功能

以下针对此同一资源的 HTTP POST 请求使用 query 端点从指标集中检索特定数据。 

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

在请求正文中，传递查询选项以根据特定条件检索指标。 

{
  "timeline_spec": {
    "aggregation_period": "DAILY"
    "start_time": { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
    "end_time": { year: "2021" month: "7" day: "3" time_zone: "America/Los_Angeles" }
   }
  "dimensions": ["apiLevel"]
  "metrics": ["errorReportCount", "distinctUsers"]
  "page_size": "10"
}

下面提供了几个集合级的示例：

字段
timelineSpec

object (TimelineSpec)

时间轴聚合参数的规范。请查看每个指标集的文档，了解支持哪些汇总周期。

dimensions[]

string

用于对指标进行切分的维度。请查看每个指标集的文档，了解支持哪些维度的列表。
metrics[]

string

要聚合的指标。
pageSize

integer

返回的数据的大小上限。

如果未指定，则最多返回 1, 000 行。最大值为 100,000；大于 100,000 的值会强制转换为 100,000。

处理响应

处理完包含有效字段的有效请求之后，服务器将发回一个 HTTP 200 OK 状态代码以及所请求的数据。如果 fields 查询参数出现错误或因其他原因而无效，服务器将返回一个 HTTP 400 Bad Request 状态代码以及一条错误消息，告知用户他们的字段选择出现了什么错误（例如 "Invalid field timeline_spec"）。

以下是上文简介部分所介绍的响应示例。 

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/com.example.app/crashRateMetricSet:query

响应如下所示：

200 OK
 
{
  rows: [
    {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "20"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "100"},
        {metric: "distinctUsers" decimal_value: "57"},
      ]
    }, {
      aggregation_period: "DAILY"
      start_time: { year: "2021" month: "7" day: "1" time_zone: "America/Los_Angeles" }
      dimensions: [{dimension: "apiLevel" int64_value: "21"}]
      metrics: [
        {metric: "errorReportCount" decimal_value: "123"},
        {metric: "distinctUsers" decimal_value: "65"},
      ]
    },
    ...
  ]
  next_page_token: "eW91IGhhdmUgdG9vIG11Y2ggZnJlZSB0aW1l"
}

注意：对于支持使用查询参数进行数据分页（例如 maxResults 和 nextPageToken）的 API，请使用这些参数将每个查询的结果缩减为易于管理的大小。