Method: vitals.anrrate.query

Запрашивает метрики в наборе метрик.

HTTP-запрос

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

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

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

Параметры
name

string

Обязательно. Имя ресурса.

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

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

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

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

object ( TimelineSpec )

Спецификация параметров агрегации временной шкалы.

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

  • DAILY : показатели агрегируются по календарным интервалам. В связи с историческими ограничениями часовой пояс по умолчанию и единственный поддерживаемый — America/Los_Angeles .
  • HOURLY : метрики агрегируются почасово. Часовой пояс по умолчанию и единственный поддерживаемый — UTC .
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». Ссылка
  • 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

Показатели для агрегации.

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

  • anrRate ( google.type.Decimal ): процент отдельных пользователей в период агрегации, которые столкнулись хотя бы с одной ошибкой ANR.
  • anrRate7dUserWeighted ( google.type.Decimal ): скользящее среднее значение anrRate за последние 7 дней. Ежедневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • anrRate28dUserWeighted ( google.type.Decimal ): скользящее среднее значение anrRate за последние 28 дней. Ежедневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • userPerceivedAnrRate ( google.type.Decimal ): процент отдельных пользователей за период агрегации, столкнувшихся хотя бы с одной ошибкой ANR, воспринятой пользователем. В настоящее время ошибки ANR, воспринятые пользователем, относятся к типу «Диспетчеризация ввода».
  • userPerceivedAnrRate7dUserWeighted ( google.type.Decimal ): скользящее среднее значение userPerceivedAnrRate за последние 7 дней. Ежедневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • userPerceivedAnrRate28dUserWeighted ( google.type.Decimal ): скользящее среднее значение userPerceivedAnrRate за последние 28 дней. Ежедневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • distinctUsers ( google.type.Decimal ): количество отдельных пользователей за период агрегации, которые использовались в качестве нормализованного значения для метрик anrRate и userPerceivedAnrRate . Пользователь учитывается в этой метрике, если он использовал приложение в активном режиме в течение периода агрегации. Необходимо соблюдать осторожность, чтобы не суммировать это количество, так как это может привести к многократному подсчёту пользователей. Значение округляется до ближайшего числа, кратного 10, 100, 1000 или 1 000 000, в зависимости от величины значения.
filter

string

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

pageSize

integer

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

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

pageToken

string

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

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

userCohort

enum ( UserCohort )

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

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

  • OS_PUBLIC для выбора данных из всех публично выпущенных версий Android. Используется по умолчанию. Поддерживает все указанные выше параметры.
  • APP_TESTERS для сбора данных от пользователей, согласившихся участвовать в тестировании. Поддерживает все указанные выше параметры.
  • OS_BETA — выборка данных только из бета-версий Android, без учёта данных из выпущенных версий Android. Поддерживаются только следующие параметры:

  • versionCode ( int64 ): версия приложения, работавшего на устройстве пользователя.

  • osBuild ( string ): сборка ОС устройства пользователя, например, «T1B2.220916.004».

Тело ответа

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

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

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

object ( MetricsRow )

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

nextPageToken

string

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

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

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

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

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