Method: vitals.errors.issues.search

string

Obrigatório. Recurso pai dos problemas de erro, indicando o aplicativo para o qual eles foram recebidos.

Formato: apps/{app}

object (DateTimeInterval)

O intervalo de data e hora para pesquisar problemas de erro. 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 problemas de erro com relatórios de erros associados 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 problemas de erro a serem retornados. O serviço pode retornar menos que esse valor.

Se não for especificado, no máximo 50 problemas de erro serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.

string

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

Na paginação, todos os outros parâmetros enviados para a solicitação precisam corresponder à chamada que proporcionou o token da página.

string

Um predicado de seleção para recuperar apenas um subconjunto dos problemas. As contagens nos problemas de erro retornados refletem apenas as ocorrências que corresponderam ao filtro.

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

** Nomes de campos compatíveis:

• apiLevel: corresponde apenas a problemas de erro 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 problemas de erro 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 problemas de erro que ocorreram nos tipos de dispositivos solicitados. Exemplo: deviceType = "PHONE".
• errorIssueType: corresponde apenas a problemas de erro dos tipos solicitados. Candidatos válidos: CRASH, ANR, NON_FATAL. Exemplo: errorIssueType = CRASH OR errorIssueType = ANR.
• appProcessState: corresponde a problemas de erro 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 problemas de erro 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 errorIssueType = ANR não é um filtro válido.

** 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)

string

Especifica um campo que será usado para ordenar os resultados.

** Dimensões aceitas:

• errorReportCount: ordena os problemas por número de relatórios de erros.
• distinctUsers: ordena os problemas pelo número de usuários únicos afetados.

** Operações compatíveis:**

• asc para ordem crescente.
• desc para ordem decrescente.

Formato: um campo e uma operação, por exemplo, errorReportCount desc

Observação:no momento, apenas um campo é aceito por vez.

integer

Opcional. Número de relatórios de erros de amostra a serem retornados por ErrorIssue. Se não for especificado, será usado 0. Observação:no momento, apenas 0 e 1 são aceitos.