Method: vitals.errors.reports.search

string

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

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

object ( DateTimeInterval )

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

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

integer

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

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

string

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

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

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)