Method: vitals.excessivewakeuprate.query

Выполняет запрос к метрикам в заданном наборе метрик.

HTTP-запрос

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/excessiveWakeupRateMetricSet}:query

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Обязательно. Название ресурса.

Формат: apps/{app}/excessiveWakeupRateMetricSet

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Поля
timelineSpec

object ( TimelineSpec )

Необязательно. Указание параметров агрегирования временной шкалы.

Поддерживаемые периоды агрегирования:

  • DAILY : показатели агрегируются по календарным датам. Из-за исторических ограничений поддерживается только часовой пояс America/Los_Angeles .
dimensions[]

string

Необязательно. Размеры, по которым будут разделены данные.

Поддерживаемые размеры:

  • apiLevel ( string ): уровень API Android, работающий на устройстве пользователя, например, 26.
  • versionCode ( int64 ): версия приложения, работавшего на устройстве пользователя.
  • deviceModel ( string ): уникальный идентификатор модели устройства пользователя. Формат идентификатора — 'deviceBrand/device', где deviceBrand соответствует Build.BRAND, а device — Build.DEVICE, например, google/coral.
  • deviceBrand ( string ): уникальный идентификатор марки устройства пользователя, например, Google.
  • deviceType ( string ): тип (также известный как форм-фактор) устройства пользователя, например, PHONE.
  • countryCode ( string ): страна или регион устройства пользователя, определяемый по его IP-адресу, представленный в виде двухбуквенного кода ISO-3166 (например, US для Соединенных Штатов).
  • deviceRamBucket ( int64 ): Объем оперативной памяти устройства в МБ, разделенный на блоки (3 ГБ, 4 ГБ и т. д.).
  • deviceSocMake ( string ): Производитель основной системы на кристалле устройства, например, Samsung. Ссылка
  • deviceSocModel ( string ): Модель основной системы на кристалле устройства, например, "Exynos 2100". Reference
  • deviceCpuMake ( string ): Производитель процессора устройства, например, Qualcomm.
  • deviceCpuModel ( string ): Модель процессора устройства, например, "Kryo 240".
  • deviceGpuMake ( string ): Make-код графического процессора устройства, например, ARM.
  • deviceGpuModel ( string ): Модель графического процессора устройства, например, Mali.
  • deviceGpuVersion ( string ): Версия графического процессора устройства, например, T750.
  • deviceVulkanVersion ( string ): Версия Vulkan устройства, например, "4198400".
  • deviceGlEsVersion ( string ): Версия OpenGL ES устройства, например, "196610".
  • deviceScreenSize ( string ): Размер экрана устройства, например, NORMAL, LARGE.
  • deviceScreenDpi ( string ): Плотность пикселей экрана устройства, например, mdpi, hdpi.
metrics[]

string

Необязательно. Метрики для агрегирования.

Поддерживаемые метрики:

  • excessiveWakeupRate ( google.type.Decimal ): Процент уникальных пользователей за период агрегации, у которых было более 10 пробуждений в час.
  • excessiveWakeupRate7dUserWeighted ( google.type.Decimal ): Скользящее среднее значение excessiveWakeupRate за последние 7 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
  • excessiveWakeupRate28dUserWeighted ( google.type.Decimal ): Скользящее среднее значение excessiveWakeupRate за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
  • distinctUsers ( google.type.Decimal ): Количество уникальных пользователей за период агрегации, которые использовались в качестве значения для нормализации метрики excessiveWakeupRate . Пользователь учитывается в этой метрике, если приложение выполняло какую-либо работу на устройстве, то есть не только активное использование на переднем плане, но и фоновую работу. Следует проявлять осторожность и не агрегировать это число дальше, так как это может привести к многократному подсчету пользователей. Значение округляется до ближайшего числа, кратного 10, 100, 1000 или 1 000 000, в зависимости от величины значения.
filter

string

Необязательно. Фильтры для применения к данным. Выражение фильтрации соответствует стандарту AIP-160 и поддерживает фильтрацию по равенству всех размерностей разбивки.

pageSize

integer

Необязательный параметр. Максимальный размер возвращаемых данных.

Если значение не указано, будет возвращено не более 1000 строк. Максимальное значение — 100000; значения выше 100000 будут преобразованы в 100000.

pageToken

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова. Укажите его, чтобы получить следующую страницу.

При использовании постраничной навигации все остальные параметры, переданные в запрос, должны соответствовать вызову, который предоставил токен страницы.

userCohort

enum ( UserCohort )

Необязательно. Выбор представления пользователя. Выходные данные будут соответствовать выбранному представлению. Поддерживается только значение OS_PUBLIC .

Ответный текст

Ответное сообщение для excessivewakeuprate.query .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Поля
rows[]

object ( MetricsRow )

Возвращены строки данных.

nextPageToken

string

Токен продолжения для загрузки следующей страницы данных.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Для получения более подробной информации см.OAuth 2.0 Overview .