Method: vitals.anrrate.query

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

HTTP-запрос

POST https://playdeveloperreporting.googleapis.com/v1beta1/{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". 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

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

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

  • anrRate ( google.type.Decimal ): Процент уникальных пользователей за период агрегирования, у которых наблюдалась хотя бы одна ошибка ANR.
  • anrRate7dUserWeighted ( google.type.Decimal ): Скользящее среднее значение anrRate за последние 7 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается в почасовом масштабе.
  • anrRate28dUserWeighted ( google.type.Decimal ): Скользящее среднее значение anrRate за последние 28 дней. Ежедневные значения взвешиваются по количеству уникальных пользователей за день. Не поддерживается в почасовом масштабе.
  • userPerceivedAnrRate ( google.type.Decimal ): Процент уникальных пользователей за период агрегирования, которые столкнулись хотя бы с одним зарегистрированным пользователем сообщением об ошибке. В настоящее время зарегистрированные пользователем сообщения об ошибке относятся к типу «Входная диспетчеризация».
  • 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 .