API de desarrolladores de Google Play

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

No todos los desarrolladores necesitarán usar estas API. En la mayoría de los casos, continuarás administrando tus apps directamente con Google Play Console. Sin embargo, si tienes una gran cantidad de APK para administrar, o bien si tienes que hacer el seguimiento de compras y suscripciones de usuarios, es probable que esta API te resulte muy útil.

Mediante la API de desarrolladores de Google Play, puedes automatizar varias tareas de administración de apps, incluidas las siguientes:

  • Carga y lanzamiento de versiones nuevas de tu app
  • Edición de las fichas de Google Play Store de tu app, incluidos los gráficos y el texto localizado
  • Administración de tu catálogo de productos integrados en la aplicación, el estado de compra de tus productos y las suscripciones a tu app

La API de desarrolladores de Google Play te permite concentrarte en diseñar y desarrollar la app, al mismo tiempo que dedicas menos tiempo y esfuerzo en administrar tus versiones, incluso mientras te expandes hacia mercados nuevos.

La API de desarrolladores de Google Play incluye dos componentes:

API de publicación

La API de publicación para desarrolladores de Google Play te permite automatizar las tareas frecuentes relacionadas con la distribución de apps. Esto incluye funciones similares a aquellas disponibles en Play Console, incluidas las siguientes:

  • Subir versiones nuevas de una app
  • Lanzar apps mediante la asignación de APK a los distintos segmentos (Alfa, Beta, lanzamiento en etapas o producción)
  • Crear y modificar fichas de Google Play Store, incluidos los gráficos y el texto localizado, y las capturas de pantalla en varios dispositivos

Esas tareas se llevan a cabo mediante la funcionalidad de ediciones, que adopta un enfoque transaccional para realizar cambios: se agrupan varios cambios en una sola edición de borrador y, luego, se aplican todos los cambios a la vez. (Ninguno de los cambios surte efecto hasta que se confirma la edición).

Nota: No todos los desarrolladores necesitarán usar esta API. Todas las funcionalidades que ofrece la API también están disponibles mediante Google Play Console. Sin embargo, esta API te permite integrar el proceso de actualización de tu app y ficha con tus herramientas existentes, lo que será muy útil para algunos desarrolladores. En particular, esta app podría resultarte muy valiosa si tienes una gran cantidad de APK para administrar o fichas localizadas en muchas configuraciones regionales diferentes.

API de suscripciones y compras directas desde la aplicación

Esta API te permite administrar el catálogo de suscripciones y productos integrados en la aplicación de tu app. Además, con esta API, puedes usar una solicitud GET estándar para recuperar los detalles de cualquier compra rápidamente. En la solicitud, debes brindar información sobre la compra: el nombre del paquete de apps, el ID de compra o suscripción y el token de compra. El servidor responde con un objeto JSON que describe los detalles de compra asociados, el estado del pedido, la carga útil de desarrollador y más información.

Puedes usar la API de estado de compra de varias maneras. Por ejemplo, para informar y conciliar pedidos individuales, y para verificar vencimientos de suscripciones y compras. También puedes usar la API para obtener más información sobre los pedidos cancelados y confirmar si se consumieron productos integrados en la aplicación, además de si se consumieron antes de ser cancelados.

Nota: La API de suscripciones y compras directas desde la aplicación no usa la funcionalidad nueva y transaccional de "ediciones" que usa la API de publicación. Los métodos para los recursos Inappproducts, Purchases.products y Purchases.subscriptions surten efecto inmediatamente. En las notas de las páginas de referencia de la API de cada recurso, puedes consultar si los métodos de ese recurso específico utilizan el modelo de "ediciones".

La API de estado de compra forma parte de la API de desarrolladores de Google Play v. 2.0 y está disponible en Google Developers Console.

Cómo usar la API

Para comenzar a realizar llamadas a la API, deberás configurar y administrar la API de desarrolladores de Google Play directamente desde Google Play Console. Solo el propietario de tu cuenta de desarrollador de Google Play puede administrarla.

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

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

Para obtener la información completa, visita la página Comenzar de la API de desarrolladores de Google Play.

Ediciones por etapas

Los métodos de edición de la API de publicación para desarrolladores de Google Play te permiten preparar y confirmar cambios en tus apps de Google Play. Una vez que tu actualización esté lista, puedes implementarla con una sola operación. Entre los cambios que puedes hacer se incluyen los siguientes:

  • Subir uno o más APK
  • Asignar APK diferentes a "segmentos" distintos: Alfa, Beta, lanzamiento en etapas y producción
  • Crear y modificar fichas de Play Store localizadas para la app
  • Subir capturas de pantalla y otras imágenes a las fichas de Play Store de la app

Una vez que se hayan implementado todos los cambios deseados, se confirmarán en su totalidad con una sola operación.

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

Nota: Solo la API de publicación usa la funcionalidad nueva y transaccional de "ediciones". Los métodos de la API de suscripciones y compras directas desde la aplicación surten efecto inmediatamente. En las notas de las páginas de referencia de la API de cada recurso, puedes consultar si los métodos de ese recurso específico utilizan el modelo de "ediciones".

Cómo usar la API de manera eficiente

El acceso a la API de desarrolladores de Google Play está regulado para ayudar a garantizar un entorno de alto rendimiento para todas las apps que lo usan (como se describe en cuota). Aunque puedes solicitar una cuota diaria más alta para tu app, te recomendamos minimizar el acceso mediante 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 deberían 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 que si existe un problema grave en tu app, debes corregirlo.)
  • Consulta la API de estado de compra solo para compras nuevas: en el momento de la compra, tu app puede transferir el token de compra y otros detalles a tus servidores de backend, que pueden usar la API de estado de compra para verificar la compra.
  • Almacena los detalles de compra en la caché de tus servidores: en la medida de lo posible, almacena en la caché de tus servidores de backend los detalles de compra de suscripciones y productos integrados en la aplicación. Si la app se comunica con tus servidores de backend durante el tiempo de ejecución para verificar la validez de la compra, tu servidor puede verificarla según la información almacenada en caché, a fin de minimizar el uso de la API de estado de compra y brindar al usuario una respuesta y una experiencia tan rápida y efectiva como sea posible.
  • Almacena información sobre el vencimiento de la suscripción en tus servidores: tus servidores deben usar la API de estado de compra para consultar la fecha de vencimiento de tokens de suscripción nuevos y, luego, almacenar la fecha de vencimiento a nivel local. Esto te permite verificar el estado de las suscripciones solo en el momento del vencimiento o después de él (más información a continuación).
  • Consulta el estado de la suscripción solo en el momento del vencimiento: una vez que tu servidor haya recuperado la fecha de vencimiento de los tokens de suscripción, no debe volver a consultar los servidores de Google Play con respecto al estado de la suscripción hasta que la suscripción esté cerca de la fecha de vencimiento o la haya superado. Por lo general, tus servidores ejecutan una consulta por lote cada día para verificar 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 nunca deben consultar el estado de suscripción de manera dinámica, según las solicitudes individuales de tu app de Android.

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

Cuota

Las aplicaciones que usan la API de desarrolladores de Google Play están limitadas a una cuota de uso de cortesía inicial de 200,000 solicitudes por día (por app). Esto debería brindar acceso suficiente para las actividades de publicación y las necesidades normales de suscripción o validación.

Si necesitas solicitar un límite más alto para tu aplicación, usa el vínculo "Solicitar más" en el panel Cuotas de Google Developers Console.