Method: vitals.crashrate.query

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

HTTP-запрос

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

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

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

Параметры
name

string

Необходимый. Имя ресурса.

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

Тело запроса

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

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 (например, США для США).
  • 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

Метрики для агрегирования.

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

  • crashRate ( google.type.Decimal ): процент отдельных пользователей за период агрегации, у которых произошел хотя бы один сбой.
  • crashRate7dUserWeighted ( google.type.Decimal ): скользящее среднее значение « crashRate за последние 7 дней. Дневные значения взвешиваются по количеству отдельных пользователей за день.
  • crashRate28dUserWeighted ( google.type.Decimal ): скользящее среднее значение crashRate за последние 28 дней. Дневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • userPerceivedCrashRate ( google.type.Decimal ): процент отдельных пользователей за период агрегирования, у которых произошел хотя бы один сбой во время активного использования вашего приложения (сбой, воспринимаемый пользователем). Приложение считается активно используемым, если оно отображает какую-либо активность или выполняет какую-либо службу переднего плана.
  • userPerceivedCrashRate7dUserWeighted ( google.type.Decimal ): скользящее среднее значение userPerceivedCrashRate за последние 7 дней. Дневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • userPerceivedCrashRate28dUserWeighted ( google.type.Decimal ): скользящее среднее значение userPerceivedCrashRate за последние 28 дней. Дневные значения взвешиваются по количеству отдельных пользователей за день. Не поддерживается почасовая детализация.
  • distinctUsers ( google.type.Decimal ): количество отдельных пользователей за период агрегирования, которые использовались в качестве значения нормализации для показателей crashRate и userPerceivedCrashRate . Пользователь учитывается в этом показателе, если он активно использовал приложение в течение периода агрегирования. Приложение считается активно используемым, если оно отображает какую-либо активность или выполняет какую-либо службу переднего плана. Необходимо соблюдать осторожность, чтобы не агрегировать эти данные в дальнейшем, так как это может привести к тому, что пользователи будут учитываться несколько раз. Значение округляется до ближайшего числа, кратного 10, 100, 1 000 или 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».

Тело ответа

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

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

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

object ( MetricsRow )

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

nextPageToken

string

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .