Method: vitals.errors.issues.search

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

HTTP-запрос

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

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

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

Параметры
parent

string

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

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

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

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

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

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

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

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

sampleErrorReportLimit

integer

Необязательно. Количество примеров отчётов об ошибках, возвращаемых для каждого ErrorIssue. Если не указано, будет использоваться 0. Примечание: в настоящее время поддерживаются только значения 0 и 1.

Текст запроса

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

Тело ответа

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

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

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

object ( ErrorIssue )

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

nextPageToken

string

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

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

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

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

Для получения более подробной информации см.OAuth 2.0 Overview .