Method: vitals.errors.reports.search

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

HTTP-запрос

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

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

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

Параметры
parent

string

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

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

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

Параметры
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 : Соответствует только отчётам об ошибках запрошенных типов. Допустимые варианты: CRASH , ANR , NON_FATAL . Пример: errorIssueType = CRASH OR errorIssueType = ANR .
  • errorIssueId : Сопоставляет только отчёты об ошибках, относящиеся к запрошенным идентификаторам ошибок. Пример: errorIssueId = 1234 OR errorIssueId = 4567 .
  • errorReportId : сопоставляет отчёты об ошибках с запрошенным идентификатором отчёта об ошибках. Пример: errorReportId = 1234 OR errorReportId = 4567 .
  • appProcessState : сопоставляет отчёты об ошибках в состоянии процесса приложения, указывая, работает ли приложение на переднем плане (видимое пользователю) или в фоновом режиме. Допустимые варианты: FOREGROUND , BACKGROUND . Пример: appProcessState = FOREGROUND .
  • isUserPerceived : Сопоставляет сообщения об ошибках, обнаруженных пользователем. Не сопровождается никакими операторами. Пример: isUserPerceived .

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

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

Оператор 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 Overview .