lightbulb_outline Help shape the future of the Google Play Console, Android Studio, and Firebase. Start survey

Google Play Developer API

La Google Play Developer API es un servicio web basado en REST que te permite realizar tareas de publicación y gestión de apps. Puedes usar esta API para integrar tus operaciones de publicación con tu proceso de gestión de versiones.

No todos los desarrolladores necesitarán usar estas API; en la mayoría de los casos, necesitarás seguir gestionando tus apps directamente a través de la Google Play Developer Console. Sin embargo, si tienes una gran cantidad de APK para gestionar o tienes que realizar el seguimiento de las compras y suscripciones de los usuarios, esta API puede resultarte muy útil.

Por medio de la Google Play Developer API, puedes automatizar varias tareas de gestión de apps, incluidas las siguientes:

  • carga y lanzamiento de nuevas versiones de tu aplicación;
  • edición de los directorios de Google Play Store para tu app, como textos y gráficos localizados;
  • gestión de tu catálogo de productos integrados en la aplicación, los estados de compra de tus productos y tus suscripciones para apps.

La Google Play Developer API te permite concentrarte en diseñar y desarrollar tu app, y al mismo tiempo invertir menos tiempo y esfuerzo en gestionar tus versiones, incluso mientras te expandes hacia nuevos mercados.

En Google Play Developer API se incluyen dos componentes:

  • La Publishing API te permite subir y publicar apps, y realizar otras tareas relacionadas con la publicación.
  • La Subscriptions and In-App Purchases API te permite gestionar compras y suscripciones integradas en la aplicación. (Esto se conocía anteriormente como la “Purchase Status API”).

Publishing API

La Google Play Developer Publishing API te permite automatizar tareas frecuentes relacionadas con la distribución de apps. Esto proporciona funciones similares a aquellas disponibles para un desarrollador a través de la Google Play Developer Console, tales como las siguientes:

  • subir nuevas versiones de una app;
  • lanzar nuevas apps asignando APK a varios canales (alfa, beta, implementación por etapas, o producción);
  • crear y modificar los directorios de Google Play Store, incluidos los textos y gráficos, y también capturas de pantalla en distintos dispositivos.

Esas tareas se llevan a cabo usando la funcionalidad de ediciones, que adopta un enfoque transaccional para realizar cambios; se agrupan numerosos cambios en una única edición provisoria y luego se confirman todos los cambios a la vez. (Ninguno de los cambios tiene efecto hasta que se confirma la edición).

Nota: No todos los desarrolladores necesitarán usar esta API. Toda la funcionalidad que ofrece esta API también se encuentra disponible a través de la Google Play Developer Console. Sin embargo, esta API te permite integrar tu app y el proceso de actualización del directorio con tus herramientas actuales, lo cual será muy útil para algunos desarrolladores. En particular, si tienes una gran cantidad de APK para gestionar, o directorios localizados en muchas configuraciones regionales diferentes, esta API puede resultarte muy valiosa.

Subscriptions and In-App Purchases API

La API te permite gestionar el catálogo de productos integrados en la aplicación y de suscripciones para tu app. Además, con la Subscriptions and In-App Purchases API puedes recuperar rápidamente los detalles de cualquier compra por medio de una solicitud GET estándar. En la solicitud proporcionas información sobre la compra: el nombre del paquete de la app, el ID de compra o suscripción y el token de la compra. El servidor responde con un objeto JSON que describe los detalles de la compra asociada, el estado del pedido y la carga útil del desarrollador, entre otros aspectos.

Puedes usar la Purchase Status API de distintas formas; por ejemplo, para el informe y la conciliación de pedidos individuales, y para la verificación de compras y caducidad de las suscripciones. También puedes usar la API para conocer pedidos cancelados y confirmar si los productos integrados en la aplicación se han consumido; incluso si se consumieron antes de su cancelación.

Nota: La Subscriptions and In-App Purchases API no usa la nueva funcionalidad transaccional de “ediciones” que usa la Publishing API. Los métodos para los recursos Inappproducts, Purchases.products, y Purchases.subscriptions tienen efecto de inmediato. La página de referencia de la API de cada recurso indica específicamente si los métodos para ese recurso usan el modelo de “ediciones”.

La Purchase Status API es parte de la Google Play Developer API v. 2.0, disponible a través de la Google Developers Console.

Cómo usar la API

Para comenzar a realizar llamadas de API, configurarás y gestionarás la Google Play Developer API directamente desde la Google Play Developer Console. Solo el propietario de tu cuenta de Google Play Developer puede gestionar la API.

Para acceder a la API, necesitarás hacer lo siguiente:

  1. Configura un proyecto de API nuevo o existente
  2. Configura uno o más clientes autorizados. Pueden ser los siguientes:

Para obtener la información completa, visita la página Primeros pasos de la Google Play Developer API.

Ediciones por etapas

Los métodos de edición de la Google Play Developer Publishing API te permiten preparar y confirmar cambios en tus apps de Google Play. Cuando tu actualización esté lista, puedes implementarla con una única operación. Entre los cambios que puedes hacer se incluyen los siguientes:

  • subir uno o más APK;
  • asignar diferentes APK a diferentes “canales”: alfa, beta, implementación por etapas y producción;
  • crear y modificar directorios de la tienda localizados para la app;
  • cargar capturas de pantalla y otras imágenes para los directorios de la tienda de la app.

Cuando todos los cambios deseados se hayan dispuesto, se confirmarán en su totalidad con una única operación.

Para obtener la información completa sobre las ediciones por etapas, consulta la página Ediciones de la Google Play Developer API.

Nota: La nueva funcionalidad transaccional de “ediciones” se usa únicamente a través de la Publishing API. Los métodos para la Subscriptions and In-App Purchases API tienen efecto de inmediato. La página de referencia para la API de cada recurso indica específicamente si los métodos para ese recurso usan el modelo de “ediciones”.

Cómo usar la API de manera eficiente

El acceso a la Google Play Developer API está regulado para ayudar a garantizar un ambiente de alto rendimiento para todas las aplicaciones que la usen (como se describe en Cuota). Aunque puedes solicitar una cuota diaria mayor para tu aplicación, te recomendamos minimizar tu acceso con estas técnicas:

  • Limita la cantidad de actualizaciones de apps: no publiques actualizaciones alfa o beta con una frecuencia superior a la diaria. (Las apps de producción deben actualizarse con una frecuencia incluso menor). Cada actualización implica tiempo y probablemente dinero para tus usuarios. Si implementas actualizaciones con demasiada frecuencia, los usuarios comenzarán a ignorarlas, o incluso desinstalarán el producto. (Por supuesto, si existe un problema grave en tu app debes corregirlo).
  • Consulta la Purchase Status API únicamente para compras nuevas: en el momento de la compra, tu app puede pasar el token de compra y otros detalles a tus servidores de backend, que pueden usar la Purchase Status API para verificarla.
  • Guarda la información de la compra en el caché de tus servidores: en la medida de lo posible, almacena en caché la información de la compra para productos integrados en la aplicación y suscripciones en tus servidores de backend. Si tu app contacta a tus servidores de backend durante el tiempo de ejecución para verificar la validez de la compra, tu servidor puede verificar la compra según la información almacenada en caché, para minimizar el uso de la Purchase Status API y dar la respuesta más rápida posible (y la mejor experiencia) para el usuario.
  • Almacena el vencimiento de la suscripción en tus servidores: tus servidores deben usar la Purchase Status API a fin de consultar la fecha de caducidad para nuevos tokens de suscripciones y luego almacenar la fecha de vencimiento de forma local. Esto te permite controlar el estado de las suscripciones únicamente en el momento del vencimiento o luego de este (consulta la sección siguiente).
  • Consulta el estado de la suscripción únicamente en el momento del vencimiento: una vez que tu servidor haya recuperado la fecha de caducidad de los tokens de la suscripción, no debe consultar a los servidores de Google Play respecto del estado de la suscripción nuevamente hasta que la suscripción esté cerca de la fecha de caducidad o la haya superado. Normalmente, tus servidores ejecutan una consulta por lote cada día para controlar el estado de las suscripciones por vencer y luego actualizan la base de datos. Ten en cuenta lo siguiente:
    • Tus servidores no deben consultar todas las suscripciones todos los días.
    • Tus servidores no deben consultar nunca los estados de las suscripciones de manera dinámica, según las solicitudes individuales de tu aplicación para Android.

Si sigues esas pautas generales, tu implementación ofrecerá el mejor rendimiento posible para los usuarios.

Cuota

Las aplicaciones que usan la Google Play Developer API se encuentran limitadas a una cuota inicial de cortesía para el uso de 200 000 solicitudes por día (por aplicación). Esto debería ofrecer suficiente acceso para satisfacer las necesidades de publicación de actividades y validación de suscripciones.

Si necesitas solicitar un límite mayor para tu aplicación, usa el vínculo “Request more” del panel Quotas de la Google Developers Console.