Únete a ⁠ #Android11: The Beta Launch Show el 3 de junio.

API de Google Play Developer

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 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 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 todos lo detalles, visita la página Cómo 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 todos los detalles de 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 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 desarrolladores de Google Play 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 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.)

Compras únicas

  • Consulta la API de estado de compra solo para compras nuevas: Al 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. Cuando tu app necesite 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 desarrolladores de Google Play 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 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.