Method: vitals.errors.reports.search

Ищет все отчеты об ошибках, полученные для приложения.

HTTP-запрос

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorReports:search

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

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

Параметры
parent

string

Необходимый. Родительский ресурс отчетов с указанием приложения, для которого они были получены.

Формат: приложения/{приложение}

Параметры запроса

Параметры
interval

object ( DateTimeInterval )

Интервал даты и времени для поиска отчетов об ошибках. Начало и конец должны быть выровнены по часам и использовать UTC в качестве часового пояса (или быть пустыми, в этом случае также будет использоваться UTC ).

Если установлено, будут возвращены только отчеты об ошибках, произошедших за указанный интервал. Если не указано, будет использоваться интервал по умолчанию за последние 24 часа.

pageSize

integer

Максимальное количество возвращаемых отчетов. Служба может возвращать меньшее значение, чем это значение.

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

pageToken

string

Токен страницы, полученный в результате предыдущего вызова reports.search . Предоставьте это, чтобы получить следующую страницу.

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

filter

string

Предикат выбора для получения только подмножества отчетов.

Основы фильтрации см. в AIP-160 .

** Поддерживаемые имена полей:**

  • apiLevel : Сопоставляет отчеты об ошибках, произошедшие только в запрошенных версиях Android (указанных как числовой уровень API). Пример: apiLevel = 28 OR apiLevel = 29 .
  • versionCode : Сопоставляет отчеты об ошибках, которые произошли только в запрошенных кодах версий приложения. Пример: versionCode = 123 OR versionCode = 456 .
  • deviceModel : Сопоставляет ошибки, возникшие на запрошенных устройствах. Пример: deviceModel = "google/walleye" OR deviceModel = "google/marlin" .
  • deviceBrand : Сопоставляет ошибки, возникшие в запрошенных марках устройств. Пример: `deviceBrand = "Google".
  • deviceType : Сопоставляет отчеты об ошибках, произошедших в запрошенных типах устройств. Пример: deviceType = "PHONE" .
  • errorIssueType : Соответствует отчетам об ошибках только запрошенных типов. Допустимые кандидаты: JAVA_CRASH , NATIVE_CRASH , ANR . Пример: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH .
  • errorIssueId : Сопоставляет отчеты об ошибках, принадлежащие только запрошенным идентификаторам ошибок. Пример: errorIssueId = 1234 OR errorIssueId = 4567 .
  • appProcessState : Сопоставляет отчеты об ошибках о состоянии процесса приложения, указывая, работает ли приложение на переднем плане (видимом пользователем) или в фоновом режиме. Допустимые кандидаты: FOREGROUND , BACKGROUND . Пример: appProcessState = FOREGROUND .
  • isUserPerceived : Сопоставляет отчеты об ошибках, воспринимаемые пользователем. Он не сопровождается никакими операторами. Пример: isUserPerceived .

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

  • Операторы сравнения. Единственный поддерживаемый оператор сравнения — равенство. Отфильтрованное поле должно появиться в левой части сравнения.
  • Логические операторы. Логические операторы AND и OR можно использовать для построения сложных фильтров, следующих конъюнктивной нормальной форме (КНФ), т. е. конъюнкции дизъюнкций. Оператор OR имеет приоритет над AND , поэтому при построении CNF использование круглых скобок не требуется.

Оператор OR поддерживается только для создания дизъюнкций, применимых к одному и тому же полю, например, versionCode = 123 OR versionCode = ANR . Выражение фильтра versionCode = 123 OR errorIssueType = ANR недопустимо.

** Примеры **

Некоторые допустимые выражения фильтрации: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ с постраничным списком отчетов об ошибках, соответствующих поисковому запросу.

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

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

object ( ErrorReport )

Отчеты об обнаруженных ошибках.

nextPageToken

string

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

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

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

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

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