Method: vitals.errors.issues.search

Busca todos los problemas de error en los que se agruparon los informes.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
parent

string

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

Formato: apps/{app}

Parámetros de consulta

Parámetros
interval

object (DateTimeInterval)

Es el intervalo de fecha y hora para buscar problemas de error. 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 problemas de error con informes de errores asociados que se produjeron en el intervalo. Si no se especifica, se usará el intervalo predeterminado de las últimas 24 horas.
pageSize

integer

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

Si no se especifica, se devolverán, como máximo, 50 problemas de error. El valor máximo es 1,000; valores superiores a 1,000 se convertirán en 1,000.
pageToken

string

Es un token de página, recibido desde una llamada anterior. Proporciona esto para recuperar la página siguiente.

Cuando se realiza la paginación, todos los demás parámetros proporcionados a la solicitud deben guardar correspondencia con la llamada que proporcionó el token de la página.
filter

string

Es un predicado de selección para recuperar solo un subconjunto de los problemas. Los recuentos de los problemas de error devueltos solo reflejarán las ocurrencias que coincidieron con el filtro.

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

** Nombres de campos admitidos:**

  • apiLevel: Solo coincide con los problemas de error 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 problemas de error que ocurrieron 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 problemas de error que se produjeron en los tipos de dispositivos solicitados. Ejemplo: deviceType = "PHONE".
  • errorIssueType: Solo coincide con los problemas de error de los tipos solicitados. Candidatos válidos: CRASH, ANR, NON_FATAL. Por ejemplo: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: Coincide con los problemas de error en 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 problemas de error 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 errorIssueType = ANR no es un filtro válido.

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

string

Especifica un campo que se usará para ordenar los resultados.

** Dimensiones admitidas:**

  • errorReportCount: Ordena los problemas por cantidad de informes de errores.
  • distinctUsers: Ordena los problemas según la cantidad de usuarios únicos afectados.

** Operaciones admitidas:**

  • asc para el orden ascendente
  • desc para el orden descendente.

Formato: Un campo y una operación, p.ej., errorReportCount desc

Nota: Actualmente, solo se admite un campo a la vez.
sampleErrorReportLimit

integer

Opcional. Es la cantidad de informes de errores de muestra que se devolverán por ErrorIssue. Si no se especifica, se usará 0. Nota: Actualmente, solo se admiten 0 y 1.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta con una lista paginada de los problemas que coincidieron con la solicitud.

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

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

object (ErrorIssue)

ErrorIssues que se encontraron.
nextPageToken

string

Es un token de continuación para recuperar la siguiente página de datos.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.