Method: vitals.errors.reports.search

Pesquisa todos os relatórios de erro recebidos para um app.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Recurso pai dos relatórios, indicando a solicitação a que eles foram recebidos.

Formato: apps/{app}

Parâmetros de consulta

Parâmetros
interval

object (DateTimeInterval)

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

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

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

string

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

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

** Nomes de campos compatíveis:**

  • apiLevel: corresponde apenas a relatórios 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: corresponde a relatórios 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: 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: JAVA_CRASH, NATIVE_CRASH, ANR. Exemplo: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: corresponde apenas aos relatórios de erros que pertencem aos IDs dos problemas solicitados. Exemplo: errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState: corresponde a relatórios de erros sobre o 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 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 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)

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta com uma lista paginada de relatórios de erros que correspondem à consulta de pesquisa.

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

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

object (ErrorReport)

Relatórios de erros encontrados.
nextPageToken

string

Token da página para buscar a próxima página de relatórios.

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.