Method: vitals.errors.reports.search

string

Es obligatorio. Es el recurso principal de los informes, que indica la aplicación para la que se recibieron.

Formato: apps/{app}

object (DateTimeInterval)

Es el intervalo de fecha y hora para buscar informes de errores. Tanto el inicio como el final deben estar alineados con la hora y usar UTC como zona horaria (o estar vacíos, en cuyo caso también se usará UTC).

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

integer

Es la cantidad máxima de informes que se devolverán. El servicio puede mostrar menos que este valor.

Si no se especifica, se devolverán, como máximo, 50 informes. El valor máximo es 100, y los que superen esta cifra se convertirán a 100.

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.

string

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

Para conocer los conceptos básicos del filtrado, consulta AIP-160.

** Nombres de campos admitidos:**

• apiLevel: Coincide solo con los informes de errores que se produjeron en las versiones de Android solicitadas (especificadas como el nivel de API numérico). Ejemplo: apiLevel = 28 OR apiLevel = 29.
• versionCode: Coincide con los informes de errores que se produjeron solo en los códigos de versión de la app solicitada. Ejemplo: versionCode = 123 OR versionCode = 456.
• deviceModel: Coincide con los problemas de error que ocurrieron en los dispositivos solicitados. Ejemplo: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
• deviceBrand: Coincide con los problemas de error que se produjeron en las marcas de dispositivos solicitadas. Ejemplo: `deviceBrand = "Google"`.
• deviceType: Coincide con los informes de errores que se produjeron en los tipos de dispositivos solicitados. Ejemplo: deviceType = "PHONE".
• errorIssueType: Solo coincide con los informes de errores de los tipos solicitados. Candidatos válidos: CRASH, ANR, NON_FATAL. Por ejemplo: errorIssueType = CRASH OR errorIssueType = ANR.
• errorIssueId: Solo coincide con los informes de errores que pertenecen a los IDs de problemas de errores solicitados. Ejemplo: errorIssueId = 1234 OR errorIssueId = 4567.
• errorReportId: Coincide con los informes de errores con el ID de informe de errores solicitado. Ejemplo: errorReportId = 1234 OR errorReportId = 4567.
• appProcessState: Coincide con los informes de errores sobre el estado del proceso de una app, lo que indica 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 perciben los usuarios. No está acompañado de 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 crear filtros complejos siguiendo una forma normal conjuntiva (CNF), es decir, conjunctions of disjunctions. El operador OR tiene prioridad sobre AND, por lo que no es necesario usar paréntesis cuando se compila la FNC.

El operador OR solo se admite para crear disyunciones que se apliquen 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)