API de Google Play Developer

La API de Google Play Developer 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 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 Google Play Developer, 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 Google Play Developer te permite concentrarte en diseñar y desarrollar la app, al mismo tiempo que dedicas menos tiempo y esfuerzo a administrar tus versiones, incluso mientras te expandes hacia mercados nuevos.

La API de Google Play Developer 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. Proporciona funciones similares a las disponibles en Play Console, incluidas las siguientes:

  • Subir versiones nuevas de una app
  • Actualizar 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 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 rápidamente los detalles de cualquier compra. 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 sí utiliza la API de publicación. Los métodos para los recursos Inappproducts, Purchases.products y Purchases.subscriptions surten efecto al instante. 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 Google Play Developer 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, que pueden ser los siguientes:

Para obtener todos los detalles, visita la página Cómo comenzar de la API de Google Play Developer.

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, podrás 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 todos los detalles de las ediciones en etapas, consulta la página Ediciones de la API de Google Play Developer.

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 al instante. 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 Google Play Developer está regulado a fin de garantizar un entorno de alto rendimiento para todas las apps que lo usan (como se describe en Cuota). Si bien puedes solicitar una cuota diaria más alta para tu app, te recomendamos minimizar el acceso mediante estas técnicas:

Publicaciones

  • Limita la cantidad de actualizaciones de apps: No publiques actualizaciones Alfa o Beta más de una vez por día. (Las apps de producción deberían actualizarse aún menos frecuentemente). 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).

Compras únicas

  • 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.

Suscripciones

  • Almacena información sobre la suscripción en tu servidor para evitar hacer llamadas innecesarias a la API. Si tu app necesita verificar una suscripción, debes confiar en la información almacenada en caché en tu servidor, en lugar de repetir la llamada a la API de Google.
  • Existen dos situaciones en las que tu servidor seguro debe usar la API de Google Play Developer para obtener información sobre una suscripción:

    • Tu servidor recibe un token de compra nuevo que nunca se ha visto.
    • Tu servidor recibe una notificación para desarrolladores en tiempo real (RTDN), en la que se indica que necesitas usar el token de compra para obtener información nueva sobre la suscripción.

    Además, ten en cuenta lo siguiente:

    • No consultes la API para comprobar el estado de la suscripción de forma regular. Por ejemplo, no llames a la API todos los días para verificar cada suscripción.
    • Ya que recibes una RTDN cuando vence o se renueva la suscripción, no necesitas programar una llamada a la API según la hora de vencimiento programada.

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

Cuota

Las aplicaciones que usan la API de Google Play Developer 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.