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 .