Method: vitals.errors.issues.search

Ищет все ошибки, по которым сгруппированы отчеты.

HTTP-запрос

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorIssues:search

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

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

Параметры
parent

string

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

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

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

Параметры
interval

object ( DateTimeInterval )

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

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

pageSize

integer

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

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

pageToken

string

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

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

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

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

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

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

** Примеры **

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

orderBy

string

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

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

  • errorReportCount : Упорядочивает проблемы по количеству отчетов об ошибках.
  • distinctUsers : проблемы упорядочиваются по количеству уникальных затронутых пользователей.

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

  • asc в порядке возрастания.
  • desc для убывания порядка.

Формат: поле и операция, например errorReportCount desc

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

Тело запроса

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

Тело ответа

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

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

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

object ( ErrorIssue )

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

nextPageToken

string

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

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

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

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

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