Method: vitals.errors.reports.search

Busca todos los informes de errores recibidos de una app.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Recurso principal de los informes que indica la aplicación para la que se recibieron.

Formato: apps/{app}

Parámetros de consulta

Parámetros
interval

object (DateTimeInterval)

El intervalo de fecha y hora para buscar informes de errores. La hora de inicio y la de finalización deben alinearse con las horas y usar UTC como zona horaria (o deben estar vacías, en cuyo caso también se usará UTC).

Si se configura, solo se mostrarán los informes de errores que ocurrieron en el intervalo. Si no se especifica, se usará el intervalo predeterminado de las últimas 24 horas.
pageSize

integer

La cantidad máxima de informes que se mostrarán. Es posible que el servicio muestre menos que este valor.

Si no se especifica, se mostrarán 50 informes como máximo. El valor máximo es 100; los valores superiores a 100 se forzarán a 100.
pageToken

string

Un token de página, recibido desde una llamada reports.search anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a reports.search deben coincidir con la llamada que proporcionó el token de la página.
filter

string

Un predicado de selección para recuperar solo un subconjunto de los informes.

Para obtener información sobre los conceptos básicos del filtrado, consulta AIP-160.

** Nombres de campos admitidos:**

  • apiLevel: Coincide solo con los informes de errores que ocurrieron en las versiones de Android solicitadas (especificadas como el nivel de API numérico). Ejemplo: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Coincide solo con los informes de errores que ocurrieron en los códigos de versión de la app solicitados. Ejemplo: versionCode = 123 OR versionCode = 456.
  • deviceModel: Coincide con los problemas de errores que ocurrieron en los dispositivos solicitados. Ejemplo: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: Coincide con los problemas de errores que ocurrieron en las marcas de dispositivos solicitadas. Ejemplo: `deviceBrand = “Google”.
  • deviceType: Coincide con los informes de errores que ocurrieron en los tipos de dispositivos solicitados. Ejemplo: deviceType = "PHONE".
  • errorIssueType: Coincide con los informes de errores solo de los tipos solicitados. Candidatos válidos: JAVA_CRASH, NATIVE_CRASH y ANR. Por ejemplo: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH.
  • errorIssueId: Coincide solo con los informes de errores que pertenecen a los IDs de problema de error solicitados. Ejemplo: errorIssueId = 1234 OR errorIssueId = 4567.
  • appProcessState: Coincide con los informes de errores sobre el estado del proceso de una app que indican si una app se ejecuta en primer plano (visible para el usuario) o en segundo plano. Candidatos válidos: FOREGROUND, BACKGROUND. Ejemplo: appProcessState = FOREGROUND.
  • isUserPerceived: Coincide con los informes de errores que el usuario percibe. No lo acompaña ningún operador. Ejemplo: isUserPerceived.

** Operadores admitidos:**

  • Operadores de comparación: El único operador de comparación admitido es el de igualdad. El campo filtrado debe aparecer en el lado izquierdo de la comparación.
  • Operadores lógicos: Los operadores lógicos AND y OR se pueden usar para compilar filtros complejos con un formato normal conjuntivo (CNF), p.ej., conjunciones de disyunciones. El operador OR tiene prioridad sobre AND, por lo que no es necesario usar paréntesis cuando se compila CNF.

El operador OR solo es compatible para compilar disyunciones que se aplican al mismo campo, p.ej., versionCode = 123 OR versionCode = ANR. La expresión de filtro versionCode = 123 OR errorIssueType = ANR no es válida.

** Ejemplos **

Algunas expresiones de filtrado válidas: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta con una lista paginada de informes de errores que coinciden con la búsqueda.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
Campos
errorReports[]

object (ErrorReport)

Informes de errores encontrados.
nextPageToken

string

Token de la página para recuperar la siguiente página de informes.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.