Method: vitals.stuckbackgroundwakelockrate.query

Запрашивает показатели в наборе показателей.

HTTP-запрос

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

URL имеет синтаксис gRPC Transcoding.

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

Параметры
name

string

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

Format: apps/{app}/stuckBackgroundWakelockRateMetricSet

Тело запроса

Ниже приведена структура данных в теле запроса.

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) – ОЗУ устройства в МБ, в сегментах (например, 1024 для 1–1,5 ГБ, 4096 для 4–6 ГБ).
  • deviceSocMake (string) – производитель основной однокристальной системы устройства, например Samsung. Reference
  • deviceSocModel (string) – модель основной однокристальной системы устройства, например Exynos 2100. Reference
  • deviceCpuMake (string) – производитель ЦП устройства, например Qualcomm.
  • deviceCpuModel (string) – модель ЦП устройства, например Kryo 240.
  • deviceGpuMake (string) – производитель графического процессора устройства, например 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

Необязательное поле. Показатели, которые нужно агрегировать.

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

  • stuckBgWakelockRate (google.type.Decimal) – процент уникальных пользователей, у которых за период агрегирования запрет на переход в спящий режим в фоновом режиме действовал дольше одного часа.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal) – скользящее среднее значение показателя "stuckBgWakelockRate" за последние семь дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal) — скользящее среднее значение показателя "stuckBgWakelockRate" за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день.
  • distinctUsers (google.type.Decimal) – количество уникальных пользователей за период агрегирования, которое использовалось в качестве значения нормализации для показателя stuckBgWakelockRate. Пользователь учитывается в этом показателе, если приложение выполняло какую-либо работу на устройстве, то есть не только активно использовалось на переднем плане, но и работало в фоновом режиме. Не следует агрегировать это значение, поскольку это может привести к повторному учету пользователей. Значение округляется до ближайшего кратного 10, 100, 1000 или 1 000 000 в зависимости от величины значения.
filter

string

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

integer

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

Если значение не указано, будет возвращено не более 1000 строк. Максимальное значение – 10 000. Если указать большее значение, оно будет автоматически уменьшено до 10 000.
pageToken

string

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

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

enum (UserCohort)

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

Тело ответа

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

Ниже приведена структура данных в ответе, полученном на запрос.

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

object (MetricsRow)

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

string

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

Области авторизации

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

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

Дополнительную информацию вы найдете в OAuth 2.0 Overview.