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 – количество установок за последние семь дней.
  • 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 будут принудительно заменены на 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)

Количество уникальных пользователей, связанное с показателем (если применимо).