Method: publishers.items.queryMetrics

アイテムの指標をクエリします。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。指標をクエリするアイテムの名前。形式: publishers/{publisher}/items/{item}

クエリ パラメータ

パラメータ
timeSpec

object (TimeSpec)

必須。指標セットをクエリする時間仕様。
metrics[]

string

必須。指標セットをクエリする指標。

サポートされている指標:

  • installs: アイテムのインストール数。
  • installs-7d: 過去 7 日間のアイテムのインストール数。
  • uninstalls: アイテムのアンインストール数。
  • users: アイテムの 1 日あたりのアクティブ ユーザー数。
  • users-7d: アイテムの 7 日間のアクティブ ユーザー数。
  • impressions: ストアフロント全体でのアイテムのインプレッション数。
  • page-views: アイテムの詳細ページの閲覧数。
dimensions[]

string

省略可。指標をスライスするディメンション。指定できるディメンションは 1 つまでです。

サポートされているディメンション:

  • 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 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

MetricRow

指標とディメンションの値の 1 行。

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)

指標に関連付けられたユニーク ユーザー数（該当する場合）。