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 .