Guía para desarrolladores de la API de Play Catalog

Nota: La API de Play Catalog se lanzará el 22 de julio de 2026

La API de Play Catalog permite que las tiendas de apps de terceros (3PAS) registradas en Google Play realicen sondeos de las actualizaciones del catálogo de aplicaciones de Google Play. Los llamadores pueden obtener los detalles del catálogo de las aplicaciones que se hayan modificado o quitado desde la última exportación diaria del catálogo.

Nota: La API de Play Catalog es un complemento opcional para la exportación diaria del catálogo y ofrece la misma información. Si no necesitas datos que tengan menos de 24 horas de antigüedad, no es necesario que realices la integración con esta API.

Nota: La API de Play Catalog solo se puede usar para recuperar datos que hayan cambiado recientemente. No se puede usar para obtener un catálogo completo. Para obtener el catálogo completo de todas las aplicaciones, se debe usar la exportación del catálogo.

Para obtener una lista completa de los endpoints, los métodos y los esquemas de recursos, consulta la referencia de la API de Play Catalog.

Antes de comenzar

Debes completar la Guía de introducción principal para configurar tu acceso a la API, las credenciales de servicio y el proyecto de Google Cloud antes de poder realizar llamadas a la API de Play Catalog.

---

Diseño y arquitectura de la API

La exportación del catálogo de Play se genera cada 24 horas. La API de Play Catalog ofrece un mecanismo de sondeo intradía para obtener las actualizaciones que se produjeron desde la última exportación:

1. Sondeo de eventos de actualización: Se realiza una consulta a appstorecatalog.recentUpdateEvents.list con una ventana de startTime y endTime para identificar los nombres de paquetes que se hayan modificado o borrado.
2. Recuperación de vistas detalladas: Para cada nombre de paquete que se haya modificado, debes llamar a appstorecatalog.recentAppViews.get para recuperar los metadatos detallados de CatalogAppView.

La API es de solo lectura y se limita a devolver eventos que hayan ocurrido en las últimas 36 horas. La API tiene un límite de 2 QPS compartido entre ambos métodos.

---

1. Sondeo de eventos de actualización del catálogo

Para obtener la lista de paquetes que cambiaron dentro de una ventana específica, debes llamar al método appstorecatalog.recentUpdateEvents.list.

Solo se devuelven los eventos de actualización para las apps que reúnan los requisitos. Estos requisitos son los siguientes:

• La app debe haber aceptado la inclusión en el catálogo de la tienda de aplicaciones que realiza la llamada.
• La app debe estar publicada y disponible en Google Play Store en Estados Unidos (EE.UU.)

Nota: Se recomienda realizar los sondeos de eventos de actualización con frecuencia, por ejemplo, cada minuto. Si se realizan sondeos con poca frecuencia, es posible que se devuelva una gran cantidad de eventos de actualización a la vez, lo que dificultaría procesarlos de manera oportuna.

Descripción de los tipos de actualización

• MODIFICATION: Se activa cuando una app que reúne los requisitos se modifica, se publica por primera vez, comienza a segmentarse para EE.UU. o se habilitó recientemente para incluirse en tu catálogo.
• DELETION: Se activa cuando se anula la publicación de una app, se inhabilita su inclusión en el catálogo, se suspende o bloquea la app, o deja de segmentarse para EE.UU.

---

2. Cómo recuperar vistas de apps del catálogo

Para cada paquete que se devuelve con un evento MODIFICATION, puedes recuperar los detalles actualizados de su catálogo llamando al método appstorecatalog.recentAppViews.get.

Nota: Errores "Not Found"
El método appstorecatalog.recentAppViews.get devuelve un error NOT_FOUND (404) (No encontrado) si, en las últimas 36 horas, no se produjeron eventos de actualización para el nombre de paquete solicitado. En este caso, debes recurrir a la exportación diaria del catálogo completo.

---

3. Prácticas recomendadas y sincronización

Para mantener una base de datos de catálogo coherente en tu tienda, sigue estos lineamientos de integración:

• Sincronización de exportación diaria: Importa la lista completa de apps aptas con la exportación diaria del catálogo.
• (Opcional) Sincronización intradía: Realiza sondeos del endpoint appstorecatalog.recentUpdateEvents.list con regularidad (p. ej., cada minuto) con una ventana móvil. Asegúrate de controlar la paginación con nextPageToken.
  • Actualizaciones del proceso:
    • Para los eventos MODIFICATION, recupera el elemento CatalogAppView actualizado con appstorecatalog.recentAppViews.get y actualiza tu base de datos local.
    • En el caso de los eventos DELETION, debes quitar la app de las fichas de la tienda, o bien ocultarla para los usuarios.
  • Control de eventos de modificación repetidos: Es posible que veas varios eventos MODIFICATION para la misma app, lo que significa que la app se modificó varias veces en la ventana consultada. appstorecatalog.recentAppViews.get siempre devolverá la vista de app de la modificación más reciente.