Method: vitals.errors.reports.search

string

Obrigatório. Recurso pai dos relatórios, indicando o aplicativo para o qual eles foram recebidos.

Formato: apps/{app}

object (DateTimeInterval)

O intervalo de data e hora para pesquisar relatórios de erros. Os horários de início e término precisam estar alinhados por hora e usar UTC como fuso horário (ou estar vazios, caso em que UTC também será usado).

Se definido, somente os relatórios de erros que ocorreram no intervalo serão retornados. Se não for especificado, o intervalo padrão das últimas 24 horas será usado.

integer

O número máximo de relatórios a serem retornados. O serviço pode retornar menos que esse valor.

Se não for especificado, no máximo 50 relatórios serão retornados. O valor máximo é 100. Valores acima disso serão convertidos para 100.

string

Um token de página recebido de uma chamada reports.search anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para reports.search precisam corresponder à chamada que forneceu o token da página.

string

Um predicado de seleção para recuperar apenas um subconjunto dos relatórios.

Para conhecer os conceitos básicos de filtragem, consulte AIP-160.

** Nomes de campos compatíveis:

• apiLevel: corresponde apenas a relatórios de erros que ocorreram nas versões do Android solicitadas (especificadas como o nível numérico da API). Exemplo: apiLevel = 28 OR apiLevel = 29.
• versionCode: corresponde apenas aos relatórios de erros que ocorreram nos códigos de versão do app solicitados. Exemplo: versionCode = 123 OR versionCode = 456.
• deviceModel: corresponde a problemas de erro que ocorreram nos dispositivos solicitados. Exemplo: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
• deviceBrand: corresponde a problemas de erro que ocorreram nas marcas de dispositivos solicitadas. Exemplo: `deviceBrand = "Google".
• deviceType: corresponde a relatórios de erros que ocorreram nos tipos de dispositivos solicitados. Exemplo: deviceType = "PHONE".
• errorIssueType: corresponde apenas aos relatórios de erros dos tipos solicitados. Candidatos válidos: CRASH, ANR, NON_FATAL. Exemplo: errorIssueType = CRASH OR errorIssueType = ANR.
• errorIssueId: corresponde apenas aos relatórios de erros pertencentes aos IDs de problemas de erros solicitados. Exemplo: errorIssueId = 1234 OR errorIssueId = 4567.
• errorReportId: corresponde a relatórios de erros com o ID solicitado. Exemplo: errorReportId = 1234 OR errorReportId = 4567.
• appProcessState: corresponde a relatórios de erros no estado do processo de um app, indicando se ele é executado em primeiro plano (visível para o usuário) ou em segundo plano. Candidatos válidos: FOREGROUND, BACKGROUND. Exemplo: appProcessState = FOREGROUND.
• isUserPerceived: corresponde a relatórios de erros percebidos pelo usuário. Ela não é acompanhada de operadores. Exemplo: isUserPerceived.

** Operadores compatíveis:**

• Operadores de comparação: o único operador de comparação compatível é a igualdade. O campo filtrado precisa aparecer à esquerda da comparação.
• Operadores lógicos: os operadores lógicos AND e OR podem ser usados para criar filtros complexos seguindo uma forma normal conjuntiva (CNF), ou seja, conjunções de disjunções. O operador OR tem precedência sobre AND. Portanto, não é necessário usar parênteses ao criar uma CNF.

O operador OR só é compatível com a criação de disjunções que se aplicam ao mesmo campo, por exemplo, versionCode = 123 OR versionCode = ANR. A expressão de filtro versionCode = 123 OR errorIssueType = ANR não é válida.

** Exemplos **

Algumas expressões de filtragem válidas: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)