Google Play API de informes para desarrolladores en 2026
Google Play ya te muestra las cifras de fallos y ANR en la consola. Esa vista está pensada para una app, una persona y una tarde. La Play Developer Reporting API existe para lo otro: extraer esos mismos datos de calidad de forma programada, de todas las apps que gestionas, hacia tu propio almacén de datos o tu sistema de alertas. No es una segunda consola. Es una forma normalizada de hacer las mismas preguntas sobre cuarenta apps sin abrir cuarenta pestañas.
Este tutorial sigue la secuencia que realmente funciona en 2026, en el mismo orden en que aparecen los errores si lo haces mal: proyecto, cuenta de servicio, permiso en Play Console, descubrimiento de la app, frescura, consulta, dimensiones y anomalías. Cada paso es una llamada documentada, y los dos puntos donde más equipos fallan son la invitación en Play Console del paso 3 y la suposición de zona horaria del paso 7.
1. Conoce lo que devuelve la API antes de escribir código
El servicio expone conjuntos de métricas: grupos lógicos de métricas relacionadas que comparten una granularidad y se pueden consultar juntas. Los conjuntos documentados cubren la tasa de ANR, la tasa de fallos, la tasa de activaciones excesivas, la tasa de wakelocks en segundo plano bloqueados, la tasa de inicio lento, la tasa de renderizado lento, la tasa de LMK (finalización por memoria baja), el uso de memoria RSS anónima y swap, el uso de memoria de mapas de bits y los recuentos de errores. Cada conjunto incluye métricas normalizadas como crashRate, userPerceivedCrashRate y, junto a ellas, los promedios ponderados por usuario de 7 y 28 días.
De ese diseño se derivan dos hechos prácticos. Primero, son agregados —porcentajes de usuarios distintos, percentiles para la memoria—, así que la API se puede ejecutar desde un servidor sin manejar datos a nivel de usuario. Segundo, algunos recursos son más limitados de lo que sugiere el número de versión: el conjunto de recuentos de errores solo está disponible en la versión v1alpha1 de la API, mientras que v1beta1 y v1alpha1 exponen por lo demás los mismos recursos con las mismas formas de método. Decide tu versión por recurso, no por proyecto.
2. Crea el proyecto de Cloud y habilita la API
Todavía necesitas un proyecto de Google Cloud con la API habilitada, pero un cambio de 2026 elimina un paso que muchos siguen planificando: ya no es necesario vincular tu cuenta de desarrollador de Play a Cloud Console para usar la Reporting API. Los cuatro pasos documentados son: crear (o reutilizar) un proyecto de Cloud, habilitar en él la Google Play Developer Reporting API, crear una cuenta de servicio y conceder a esa cuenta de servicio acceso dentro de Play Console.
Activar la API es una acción de un clic en la página de la API en Cloud Console. Hazlo en el proyecto que ya contiene tu facturación e IAM, no en un proyecto desechable: las claves de cuenta de servicio sobreviven a la persona que las creó, y los proyectos huérfanos son la forma en que la monitorización muere en silencio un año después.
3. Asigna a la cuenta de servicio exactamente un alcance y luego un rol en Play Console
Las cuentas de servicio son la opción documentada para tareas no supervisadas, y se autentican con una clave JSON que nunca debe salir del servidor. Cada llamada de esta API se autoriza con un único ámbito OAuth:
https://www.googleapis.com/auth/playdeveloperreporting
Luego vienen los permisos que realmente provocan tu primer 403. Habilitar la API no es lo mismo que tener permiso para leer los datos. Ve a Usuarios y permisos en Play Console, invita a la propia dirección de la cuenta de servicio (your-name@your-project.iam.gserviceaccount.com) y concede los derechos mínimos necesarios para los conjuntos de métricas que consultas; la propia guía de Google es conceder el conjunto mínimo de permisos por acción de API, y distintos conjuntos de métricas requieren permisos distintos. Una tarea de informes nunca necesita acceso de administrador, de gestión de versiones ni financiero.
Guarda el archivo de clave fuera del repositorio y mantén una cuenta de servicio por cartera en lugar de una por app. Rotar una sola credencial es una tarea de cinco minutos; rotar treinta es un fin de semana.
4. Descubre los ID de app que puede ver la cuenta
Before any metric call, resolve which apps the credential can reach. The service endpoint is https://playdeveloperreporting.googleapis.com, and the app list comes from:
GET /v1beta1/apps:search
Ejecuta eso una vez por cartera y guarda el resultado en caché. Es la forma más barata de demostrar que la invitación del paso 3 funcionó: una lista vacía con un token válido casi siempre significa que la cuenta de servicio se invitó a la cuenta equivocada, o que se invitó pero nunca se le concedió un permiso que incluya la visibilidad de las apps.
5. Comprueba la actualidad antes de fiarte de un dato
Cada conjunto de métricas responde a un GET sencillo que devuelve la marca de tiempo del último dato disponible —su frescura—, un valor por cada granularidad admitida (diaria y horaria). Empieza cada ejecución programada por ahí en lugar de dar por hecho que existe el día anterior. Usa el valor de frescura devuelto directamente como extremo de tu rango de consulta y la tarea se alineará sola: sin retardos codificados a mano, sin respuestas vacías a la mañana siguiente de un lanzamiento tranquilo.
Un dato ausente no es un cero. Si tu almacén escribe 0,0 % porque el rango no devolvió filas, tu panel mostrará una app perfecta hasta el día en que alguien revise la consola.
6. Consulta un conjunto con el método POST :query
Los datos provienen de un método :query personalizado en el recurso de conjunto de métricas, no de una llamada de listado. Cada consulta indica una granularidad, un rango de tiempo, las métricas y las dimensiones por las que desglosar:
POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/<package>/crashRateMetricSet:query // body { "timelineSpec": { "aggregationPeriod": "DAILY", "startTime": { "year": 2026, "month": 10, "day": 14 }, "endTime": { "year": 2026, "month": 10, "day": 20 } }, "dimensions": ["versionCode", "countryCode"], "metrics": ["crashRate", "userPerceivedCrashRate", "distinctUsers"], "pageSize": 1000 }
La respuesta es una lista de filas indexadas por las dimensiones que solicitaste, más un pageToken cuando hay más por leer. filter filtra las filas por igualdad de dimensión; la paginación tiene la misma forma en todos los conjuntos de métricas, así que un paginador genérico cubre por igual la tasa de fallos, la tasa de ANR y la memoria.
7. Elige las dimensiones a propósito y vigila las dos trampas del reloj
Las dimensiones son donde la API supera a la consola. versionCode convierte una tasa de fallos de toda la flota en una comprobación de regresión por versión. countryCode aísla un mercado donde un nuevo SDK se comporta mal. Las dimensiones de dispositivo —deviceModel, deviceType, apiLevel, deviceRamBucket y los campos de SoC, CPU, GPU y pantalla— separan "se rompió nuestro código" de "se rompió este chipset".
Dos trampas de reloj acaban afectando a todos los equipos alguna vez. La agregación diaria está documentada con una zona horaria fija America/Los_Angeles, mientras que la agregación por horas está fijada a UTC. Si tu día laborable es CST, un intervalo diario no empieza cuando crees, y un lanzamiento desplegado a las 09:00 locales cae en dos intervalos. Segunda trampa: un día vacío a menudo es solo un retraso de actualización de datos, y por eso el paso 5 va primero.
También hay un límite de rendimiento estricto en la documentación que conviene tener en cuenta al diseñar: el tamaño del rango solicitado debe ser inversamente proporcional al tamaño de la app y al número de desgloses. Una app grande consultada durante treinta días en seis dimensiones agotará el tiempo de espera. Para apps grandes, recorre ventanas cortas en lugar de hacer una única consulta heroica.
8. Deja que Google detecte las anomalías
No tienes que construir cálculos de umbrales sobre estas métricas para recibir alertas. La API expone una colección de anomalías que enumera las anomalías que Google ya ha detectado en cualquiera de los conjuntos de datos, filtradas por cuándo estuvieron activas:
GET /v1beta1/apps/<package>/anomalies ?filter=activeBetween("2026-10-19T00:00:00Z","2026-10-21T00:00:00Z") &pageSize=50
Ambos límites son cadenas RFC-3339 con desplazamientos UTC permitidos, y cualquiera de los dos acepta el valor especial UNBOUNDED para ventanas de un solo lado. pageSize tiene un valor predeterminado de 10 y un máximo de 100. Cada anomalía incluye su tipo, su gravedad, las dimensiones afectadas y las métricas implicadas, de modo que una consulta programada se convierte sin problemas en un mensaje sobre el que una persona puede actuar.
Para los seguimientos de pila en lugar de las tasas, la misma API expone los problemas de error y los informes de error —las capas agrupada e individual— en ambas versiones. Esa es la diferencia entre «la tasa de fallos se duplicó en la v1.4.2» y «aquí está el frame que se movió».
9. Conéctalo al ciclo de vida de la cuenta, no solo al calendario
El permiso que concediste en el paso 3 reside en la cuenta de desarrollador, lo que significa que se traslada con la cuenta. Cuando una cuenta de Play cambia de manos —una transferencia, la venta de una cartera de apps, una reconstrucción tras una suspensión—, la Play Console del nuevo propietario debe volver a invitar a tu cuenta de servicio, o cada llamada devolverá 403 mientras tu panel conserva sus últimos valores conocidos. Ese es el fallo que conviene monitorizar de forma explícita: alerta ante un 403 y ante una lista de apps vacía, no solo ante errores 5xx, porque la API responde sin problema "sin datos" a una credencial que se ha desconectado en silencio.
Mantén el monitor aburrido: una cuenta de servicio por cartera, una ejecución programada que lea la frescura y luego consulte los conjuntos que te interesan, un sondeo de anomalías como segunda pasada y un único mensaje al día que permanezca en silencio cuando nada haya cambiado. Todo lo que añadas por encima —umbrales, líneas base de tendencias, paneles por país— es análisis que puedes incorporar sin volver a tocar la infraestructura.
¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.
Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.
← Volver a editar