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)

Opcional. O intervalo de data e hora para pesquisar relatórios de erros. O início e o fim 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

Opcional. O número máximo de relatórios a serem retornados. O serviço pode retornar um valor inferior a este.

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

string

Opcional. 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

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

Para informações básicas sobre filtragem, consulte AIP-160 (em inglês).

** Nomes de campos aceitos:**

• 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 a 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 a relatórios de erros dos tipos solicitados. Candidatos válidos: CRASH, ANR, NON_FATAL. Exemplo: errorIssueType = CRASH OR errorIssueType = ANR.
• errorIssueId: corresponde apenas a relatórios de erros pertencentes aos IDs de problemas de erro solicitados. Exemplo: errorIssueId = 1234 OR errorIssueId = 4567.
• errorReportId: corresponde a relatórios de erros com o ID de relatório de erros solicitado. Exemplo: errorReportId = 1234 OR errorReportId = 4567.
• appProcessState: corresponde a relatórios de erros no estado do processo de um app, indicando se um app é executado em primeiro plano (visível ao 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. Não é acompanhado por nenhum operador. Exemplo: isUserPerceived.

** Operadores aceitos:**

• Operadores de comparação: o único operador de comparação aceito é a igualdade. O campo filtrado precisa aparecer no lado esquerdo 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, o uso de parênteses não é necessário ao criar CNF.

O operador OR só é aceito para criar 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)