Method: publishers.items.queryMetrics

查询某项内容的指标。

HTTP 请求

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要查询其指标的项的名称。格式：publishers/{publisher}/items/{item}

查询参数

参数
timeSpec

object (TimeSpec)

必需。要查询的指标集的时间规范。
metrics[]

string

必需。要查询指标集的指标。

支持的指标：

  • installs：商品安装次数。
  • installs-7d：过去 7 天内商品安装次数。
  • uninstalls：产品卸载次数。
  • users：商品的日活跃用户数。
  • users-7d：过去 7 天内使用过该内容的用户数。
  • impressions：整个店面中的商品展示次数。
  • page-views：商品详情页面的个人浏览量。
dimensions[]

string

可选。用于对指标进行切片的维度。最多只能指定一个维度。

支持的维度：

  • os：用户的操作系统。
  • app-version：商品的版本。
  • country：用户所在的国家/地区。
  • install-source：安装来源。
  • install-type：安装类型（来自网上应用店、内嵌或其他）。
  • language：用户的语言。
  • enabled：商品是处于启用状态还是停用状态。
  • utm-campaign：用户的 UTM 广告系列。
  • utm-content：用户的 UTM 内容。
  • utm-medium：用户的 UTM 媒介。
  • utm-source：用户的 UTM 来源。
  • utm-term：用户的 UTM 字词。
pageSize

integer

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

string

可选。从之前的调用中收到的页面令牌。利用其进行后续页面检索。

进行分页时，提供给请求的所有其他参数必须与提供页面令牌的调用相一致。

请求正文

请求正文必须为空。

响应正文

针对 items.queryMetrics 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
字段
metricRows[]

object (MetricRow)

指标行。
nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

TimeSpec

用于查询指标的日期范围。

JSON 表示法 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
字段
firstDate

object (Date)

可选。时间规范的第一个日期（含）。如果未设置，则不会应用下限。
lastDate

object (Date)

可选。时间规范的最后日期（含此日期）。如果未设置，则不应用上限。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

MetricRow

单行指标和维度值。

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
字段
date

object (Date)

记录的日期。
dimensionValues[]

string

行的维度值列。
metricValues[]

object (MetricValue)

相应行的指标列。

MetricValue

表示单个指标的值

JSON 表示法 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
字段
metric

string

指标的名称
value

string (int64 format)

指标的值。
uniqueUserCount

string (int64 format)

与指标关联的唯一身份用户数（如果适用）。