Notificaciones de desarrollador en tiempo real de Google Play en 2026
Las notificaciones en tiempo real para desarrolladores (RTDN) son la forma en que Google Play avisa a tu backend de que ha ocurrido algo con una compra. No hay panel de webhooks ni clave de API por app: Play publica un mensaje en un tema de Cloud Pub/Sub dentro de tu propio proyecto de Google Cloud, y tu servidor lo recibe como push por HTTPS o lo consulta por pull. Si las operaciones de ingresos aún dependen de tareas programadas que consultan la Developer API, RTDN es la mejora: la documentación de Google señala que el uso ineficiente de la Play Developer API "puede provocar restricciones de cuota de la API".
Este tutorial sigue el orden en que realmente haces el trabajo: crear el tema, conceder permisos de publicación en Play, elegir push o pull, activar las notificaciones en Play Console y después decodificar la carga útil y actuar en consecuencia. Cada nombre de campo, tipo de notificación y paso de la consola que aparecen a continuación proceden de las dos páginas oficiales de Google, citadas al final.
Qué es RTDN, en una línea: un mensaje por cada cambio de estado de una compra — aproximadamente 1 KB por notificación, unos 2 KB por publicación más la consulta — y la obligación permanente de llamar después a la Google Play Developer API, porque la notificación «no te da información completa sobre la compra».
Paso 1 — Crea el tema de Pub/Sub en tu propio proyecto de GCP
RTDN se configura por cada app de Android, pero la capa de mensajería es tuya. Necesitas un proyecto de Google Cloud con la API de Cloud Pub/Sub habilitada y un tema al que Play publicará. Puedes reutilizar el proyecto que ya usas para la API de Play Developer o crear uno aparte: para varias apps debes usar el mismo proyecto de Google Cloud para la API de Play Developer, pero cada app individual puede publicar en su propio proyecto.
Calcula el tamaño antes de construir. La parte de datos de una notificación es de aproximadamente 1 KB por solicitud, y cada publicación más extracción es una solicitud aparte: unos 2 KB por notificación. El volumen mensual depende de tus ciclos de facturación y del comportamiento de los usuarios, pero prevé al menos una notificación por usuario y ciclo de facturación, y luego consulta los precios y las cuotas de Pub/Sub para esa cifra.
Paso 2 — Da permiso a Google Play para publicar
Un tema completamente nuevo rechaza silenciosamente las publicaciones de Play hasta que concedas acceso, y este es el paso que la gente pasa por alto. En Google Cloud Console: selecciona el proyecto, abre Pub/Sub, busca tu tema, abre los detalles de sus permisos y añade la cuenta de servicio
google-play-developer-notifications@system.gserviceaccount.com
y concédele el rol Pub/Sub Publisher. Guarda para completar la configuración del tema. Un detalle empresarial: si la configuración de uso compartido restringido por dominio de tu organización bloquea la concesión, debes añadir una excepción para esa cuenta de servicio de Google Play antes de que Play pueda publicar nada.
Paso 3 — Elige push o pull para la suscripción
Un tema no es un buzón que puedas leer; necesitas una suscripción asociada a él. Una suscripción push hace que Cloud Pub/Sub envíe solicitudes HTTPS a tu backend seguro. Una suscripción pull requiere que tu backend inicie solicitudes a Pub/Sub y recupere los mensajes. La recomendación de Google para RTDN: si tienes dudas, usa push, «ya que suele ser más fácil de implementar»; pull se usa habitualmente para optimizar el uso de recursos cuando se procesa un gran número de mensajes.
De esta elección se derivan dos reglas operativas. Para el modo pull, confirma cada mensaje que hayas extraído, o Pub/Sub seguirá reenviándolo. Para el modo push, un código de respuesta correcto de tu endpoint sirve como confirmación; un endpoint lento o con fallos implica entregas repetidas.
Paso 4: activa RTDN en Play Console y envía una prueba
- Abre Google Play Console, selecciona tu app y ve a Monetizar → Configuración de monetización.
- En la sección Notificaciones en tiempo real para desarrolladores, en la parte superior de esa página, marca Habilitar notificaciones en tiempo real.
- En el campo Nombre del tema, introduce el nombre completo del tema con el formato
projects/{project_id}/topics/{topic_name}. - Haz clic en Enviar mensaje de prueba. Para pull, abre la suscripción en Cloud Console, haz clic en Ver mensajes y extrae; luego confirma. Para push, comprueba que el mensaje de prueba llegó a tu endpoint.
- Elige el alcance de las notificaciones. Suscripciones y todas las compras anuladas te ofrece solo eventos de suscripción y de compras anuladas. Todas las notificaciones de suscripciones y productos de pago único también envía eventos de compra de productos de pago único como
ONE_TIME_PRODUCT_PURCHASEDyONE_TIME_PRODUCT_CANCELED. - Haz clic en Guardar cambios.
Cuando falla la publicación de prueba, la consola muestra un error y solo hay dos causas realistas: el nombre del tema es incorrecto o google-play-developer-notifications@system.gserviceaccount.com no tiene el rol Publicador de Pub/Sub en el tema. Corrige la concesión, no la app.
Qué contiene realmente un mensaje
Cada publicación en el tema tiene el mismo sobre: un mapa de attributes, un campo data codificado en base64, un messageId y la ruta de subscription. Decodifica data y obtienes un DeveloperNotification que lleva cuatro datos —version, packageName, eventTimeMillis— más exactamente un campo de carga útil. Esos campos de carga útil son mutuamente excluyentes: subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification o testNotification.
messageId es un identificador único de la notificación, y la guía de referencia recomienda comprobar esa unicidad para no procesar notificaciones duplicadas ni hacer llamadas redundantes a la API del backend, lo que desperdicia justamente la cuota de API que RTDN existe para proteger.
Tipos de notificaciones de suscripción
Una subscriptionNotification incluye un entero notificationType, un purchaseToken y su propio version. El conjunto actual:
- 1 — SUBSCRIPTION_RECOVERED: recuperada de una retención de cuenta o reanudada tras una pausa.
- 2 — SUBSCRIPTION_RENEWED: una suscripción activa se renovó.
- 3 — SUBSCRIPTION_CANCELED: cancelada de forma voluntaria o involuntaria; en el caso de una cancelación voluntaria, se envía cuando el usuario cancela.
- 4 — SUBSCRIPTION_PURCHASED: se compró una nueva suscripción.
- 5 — SUBSCRIPTION_ON_HOLD: entró en retención de cuenta, si la activaste.
- 6 — SUBSCRIPTION_IN_GRACE_PERIOD: entró en el periodo de gracia, si lo activaste.
- 7 — SUBSCRIPTION_RESTARTED: el usuario restauró una suscripción cancelada desde Play → Cuenta → Suscripciones antes de que caducara.
- 9 — SUBSCRIPTION_DEFERRED: se amplió el tiempo de recurrencia.
- 10 — SUBSCRIPTION_PAUSED / 11 — SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED: pausada, o el calendario de pausa cambió.
- 12 — SUBSCRIPTION_REVOKED: revocada antes de la fecha de vencimiento.
- 13 — SUBSCRIPTION_EXPIRED: la suscripción ha caducado.
- 17 — SUBSCRIPTION_ITEMS_CHANGED: cambió un elemento de un paquete de suscripción.
- 18 — SUBSCRIPTION_CANCELLATION_SCHEDULED: cancelación programada para el final de un periodo de compromiso de pago a plazos.
- 19 — SUBSCRIPTION_PRICE_CHANGE_UPDATED: se actualizaron los detalles del cambio de precio de un artículo de suscripción.
- 20 — SUBSCRIPTION_PENDING_PURCHASE_CANCELED: se canceló una transacción de suscripción pendiente.
- 22 — SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED: comenzó el periodo de consentimiento del aumento de precio o el usuario dio su consentimiento; se envía solo en las regiones donde se exige el aumento de precio.
El tipo 8 (SUBSCRIPTION_PRICE_CHANGE_CONFIRMED) está marcado como obsoleto en la referencia, así que no bases nueva lógica en él. Ten en cuenta también que estos números no son un ciclo de vida que puedas inferir: el evento te dice que el estado cambió, nunca el estado resultante.
Notificaciones de productos de pago único
Solo se envía si seleccionaste el alcance más amplio. Una oneTimeProductNotification añade un campo sku al token, con dos tipos: 1 — ONE_TIME_PRODUCT_PURCHASED (se compró correctamente un producto de pago único) y 2 — ONE_TIME_PRODUCT_CANCELED (el usuario canceló una compra de pago único pendiente). En ambos casos sigue siendo necesaria una llamada a la API para desarrolladores, porque una notificación de compra no dice nada sobre si ya has consumido o reconocido el producto.
Compras anuladas y el campo refundType
Una voidedPurchaseNotification es el RTDN que más interesa a los equipos de ingresos y, en 2026, lleva más que un token. La carga útil es purchaseToken, orderId, productType y refundType. productType es 1 para una suscripción o 2 para una compra única. refundType es 1 — REFUND_TYPE_FULL_REFUND o 2 — REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND, este último aplicable solo a compras de varias unidades, que pueden anularse parcialmente varias veces; una vez reembolsada la cantidad total restante, el tipo se informa como reembolso completo.
La guía de referencia deja claro que, para localizar la compra y el pedido correctos sobre los que ajustar los derechos, la propia notificación es suficiente, y que la Google Play API de compras anuladas es el complemento de modelo pull, que devuelve los datos de compras anuladas para un intervalo de marcas de tiempo. Para los reembolsos parciales de varias unidades, el campo refundableQuantity de purchases.productsv2 indica cuántos productos comprados siguen sin anular. Eso encaja directamente con los cambios contables de contracargos y reembolsos que tratamos en la guía de reembolsos y contracargos de Play de 2026.
Reglas del servidor que mantienen correcta la canalización
- Trata la notificación como una pregunta, no como una respuesta. Llama a la API para desarrolladores después de cada RTDN para obtener el estado completo antes de conceder, ampliar o revocar el derecho.
- Elimina duplicados por
messageId. Pub/Sub entrega al menos una vez; procesar duplicados significa llamadas a la API duplicadas y transiciones de estado duplicadas. - Confirma siempre, luego procesa. Pull: confirma los mensajes recibidos. Push: devuelve un código de éxito. Si el procesamiento tarda más que la confirmación, acepta la reentrega y haz que el controlador sea idempotente.
- Cuenta con varios eventos por usuario. Un mismo
purchaseTokenpuede generar notificaciones de compra, cancelación y caducidad para el mismo suscriptor: el controlador debe poder ejecutarse repetidamente sin problemas. - No hagas sondeos para compensar. Consultar la Developer API a la vez que RTDN es el fallo que provoca restricciones de cuota.
Verificación de tu configuración
El Enviar mensaje de prueba de la consola es la prueba de extremo a extremo más rápida: si tienes una suscripción asociada, deberías recibirlo. Un cuerpo de testNotification contiene solo un campo version, así que es una carga segura sobre la que hacer aserciones en la suite de pruebas de tu controlador. Si aún no tienes backend, usa la línea de comandos de gcloud para extraer el mensaje de la suscripción, y recuerda confirmarlo. Una canalización en buen estado se manifiesta como un flujo de eventos cuyo packageName coincide con tu app y cuyo eventTimeMillis refleja la actividad de los suscriptores en tiempo real.
Una nota sobre la planificación: el trabajo de RTDN del lado del servidor va de la mano con la fecha límite de la Biblioteca de Facturación del lado del cliente. Todas las apps nuevas y actualizaciones deben usar la Biblioteca de Facturación versión 8 o posterior, con una vía de extensión hasta el 1 de noviembre de 2026, y la verificación del servidor que consume RTDN debería estar lista al mismo tiempo.
Fuentes
¿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