Method: vitals.errors.issues.search

Busca todos los problemas de errores 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

Obligatorio. Recurso principal de los problemas de errores 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 en el que se buscarán problemas 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 problemas relacionados con los informes de errores asociados 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 problemas de errores que se mostrarán. Es posible que el servicio muestre menos que este valor.

Si no se especifican, se mostrarán 50 problemas de error como máximo. El valor máximo es 1,000; los valores superiores a 1,000 se forzarán a 1,000.

pageToken

string

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

Cuando se pagina, todos los demás parámetros proporcionados a la solicitud 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 problemas. Los recuentos en los problemas de errores mostrados solo reflejarán los casos que coincidieron con el filtro.

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

** Nombres de campos admitidos:**

  • apiLevel: Solo coincide con los problemas 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 solo con los problemas 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 problemas de errores que ocurrieron en los tipos de dispositivos solicitados. Ejemplo: deviceType = "PHONE".
  • errorIssueType: Coincide solo con problemas de errores de los tipos solicitados. Candidatos válidos: CRASH, ANR. Ejemplo: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: Compara los problemas de error en el estado del proceso de una app 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 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 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 según la cantidad de informes de errores.
  • distinctUsers: Ordena los problemas según la cantidad de usuarios afectados únicos.

** Operaciones admitidas:**

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

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

Nota: Por el momento, solo se admite un campo a la vez.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta con una lista paginada de 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

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 la Descripción general de OAuth 2.0.