Method: vitals.errors.issues.search

Pesquisa todos os problemas de erro em que os relatórios foram agrupados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Recurso pai dos problemas de erro, indicando a inscrição em que eles foram recebidos.

Formato: apps/{app}

Parâmetros de consulta

Parâmetros
interval

object (DateTimeInterval)

O intervalo de data e hora para pesquisar problemas de erro. O início e o término precisam estar alinhados à hora e usar UTC como fuso horário ou estar em branco. Nesse caso, UTC também será usado.

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

pageSize

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, serão retornados no máximo 50 problemas de erro. O valor máximo é 1.000. Valores acima desse valor serão convertidos para 1.000.

pageToken

string

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

Ao paginar, todos os outros parâmetros fornecidos à solicitação precisam corresponder à chamada que forneceu o token da página.

filter

string

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

Para noções básicas de filtragem, consulte AIP-160.

** Nomes de campos compatíveis:**

  • apiLevel: mostra somente problemas de erros que ocorreram nas versões solicitadas do Android (especificadas como o nível numérico da API). Exemplo: apiLevel = 28 OR apiLevel = 29.
  • versionCode: indica problemas de erros que ocorreram somente nos códigos de versão do app solicitados. Exemplo: versionCode = 123 OR versionCode = 456.
  • deviceModel: indica problemas de erros que ocorreram nos dispositivos solicitados. Exemplo: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: indica problemas de erros que ocorreram nas marcas dos dispositivos solicitados. Exemplo: `deviceBrand = "Google".
  • deviceType: indica problemas de erros que ocorreram nos tipos de dispositivos solicitados. Exemplo: deviceType = "PHONE".
  • errorIssueType: corresponde a problemas de erro somente dos tipos solicitados. Candidatos válidos: CRASH, ANR. Exemplo: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: procura 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: indica problemas de erro percebidos pelo usuário. Ela não é acompanhada por operadores. Exemplo: isUserPerceived.

** Operadores compatíveis:**

  • Operadores de comparação: o único operador de comparação aceito é 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, na sigla em inglês), ou seja, conjunções de disjunções. Como o operador OR tem precedência sobre AND, não é necessário usar parênteses ao criar 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)

orderBy

string

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

** Dimensões compatíveis:**

  • errorReportCount: classifica os problemas pelo número de relatórios de erros.
  • distinctUsers: ordena 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, só é possível inserir um campo por vez.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta com uma lista paginada de problemas que correspondem à solicitação.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "errorIssues": [
    {
      object (ErrorIssue)
    }
  ],
  "nextPageToken": string
}
Campos
errorIssues[]

object (ErrorIssue)

ErrorIssues encontrados.

nextPageToken

string

Token de continuação para buscar a próxima página de dados.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.