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 列。許可的最大值為 1000；超出的數值將一律指定為 1000。
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)

與指標相關聯的不重複使用者人數 (如適用)。