APIs de Google Play Developer

Descripción general

Google Play Console proporciona un paquete de APIs de servicios web basadas en REST que te permiten realizar publicaciones, informes y otras funciones de administración de apps directamente para tu aplicación.

No todos los desarrolladores necesitan usar estas APIs. En la mayoría de los casos, puedes seguir administrando tus apps con Google Play Console. Sin embargo, si tienes que administrar una gran cantidad de APKs o debes realizar un seguimiento de las compras y las suscripciones de los usuarios, estas APIs pueden resultarte útiles.

Qué se incluye

Las APIs de Google Play Developer te permiten concentrarte en diseñar y desarrollar tu app, y dedicar menos tiempo y esfuerzo a administrar tus versiones, incluso a medida que te expandes hacia nuevos mercados.

Google Play Console incluye un paquete de APIs que puedes usar para administrar tu app:

  • La API de Publishing te permite cargar y publicar apps, además de realizar otras tareas relacionadas con la publicación.
  • La API de Subscriptions and In-App Purchases te permite administrar las suscripciones y las compras directas desde la aplicación (anteriormente, se conocía como la "API de estado de compra").
  • La API de informes te permite recuperar información sobre la calidad de tu app desde Android vitals.
  • La API de Reply to Reviews te permite recuperar y responder opiniones sobre tu app.
  • La API de Permissions te permite automatizar la administración de permisos dentro de Play Console.
  • La API de Play Games Services Management te permite realizar llamadas de REST para controlar de manera programática los metadatos subyacentes a las funciones de los Servicios de juego de Google Play.
  • La API de Voided Purchases proporciona una lista de pedidos asociados con compras que anuló un usuario.

Cómo comenzar

Para comenzar a usar las APIs de Google Play Developer, consulta la documentación para comenzar.

API de Publishing

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

  • Subir versiones nuevas de una app
  • Lanzar apps a través de la asignación de APKs a los distintos segmentos (alfa, beta, lanzamiento en etapas o producción)
  • Crear y modificar fichas de Google Play Store, incluido el texto y los gráficos localizados, y las capturas de pantalla tomadas desde varios dispositivos

Esas tareas se realizan con la funcionalidad de ediciones, que adopta un enfoque transaccional para realizar cambios. Esto te permite agrupar varios cambios en una sola edición de borrador y, luego, confirmarlos todos a la vez (ninguno de los cambios entra en vigencia hasta que se confirma la edición).

Prácticas recomendadas

  • Limita la cantidad de actualizaciones de las apps. No publiques actualizaciones alfa ni beta con una frecuencia superior a la diaria (las apps de producción deben actualizarse incluso con menos frecuencia). Cada actualización implica tiempo, y probablemente dinero, para tus usuarios. Si implementas actualizaciones con demasiada frecuencia, los usuarios podrían comenzar a ignorarlas o, incluso, desinstalar el producto.

API de Subscriptions and In-App Purchases

La API de Subscriptions and In-App Purchases 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 esta API de varias maneras (por ejemplo, para informar y conciliar pedidos individuales y para verificar compras y vencimientos de suscripciones). 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.

Prácticas recomendadas

  • 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.
  • No consultes la API con frecuencia para comprobar el estado de la suscripción. Por ejemplo, no llames a la API todos los días para verificar cada suscripción.
  • Dado 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.

API de informes

La API de Reporting está dirigida a los desarrolladores que deseen compilar flujos de trabajo automatizados sobre los datos de Play Console, o a los que usen datos de Play Console para generar informes y análisis comerciales internos, junto con otros conjuntos de datos. Esto te brinda acceso programático a los datos y las métricas a nivel de la app para la generación interna de informes, el análisis y la automatización.

La API de Reporting ofrece acceso a los datos de Android vitals, incluida la tasa de fallas, la tasa de ANR, los problemas de activación y bloqueo de activación, y los seguimientos de pila de errores.

Prácticas recomendadas

  • Esta versión de la API de Reporting tiene un límite predeterminado de 10 consultas por segundo. Puedes ver el uso de tu cuota en la sección sobre cuotas de Google Cloud Console. Si necesitas superar este límite, puedes enviar una solicitud de cuota con este formulario.

API de Reply to Reviews

La API de Reply to Reviews te permite ver y responder los comentarios de los usuarios sobre tu app. Puedes usar esta API para interactuar con los usuarios de forma directa dentro de tu kit de herramientas existente de asistencia al cliente, como un sistema de CRM.

La API de Reply to Reviews te permite acceder solo a los comentarios de las versiones de producción de tu app. Si quieres ver comentarios de las versiones alfa o beta, utiliza Google Play Console. Además, ten en cuenta que la API solo muestra las opiniones que incluyen comentarios. Si un usuario califica la app, pero no proporciona un comentario, no podrás acceder a sus comentarios desde la API.

API de Permissions

La API de Permissions brinda a los desarrolladores la capacidad de automatizar la administración de permisos en Play Console. Esto te permite controlar de forma flexible quién tiene acceso a tu cuenta de desarrollador, sin participación manual.

Con la API de Permissions, puedes realizar funciones administrativas como las siguientes:

  • Quitar el acceso de los usuarios cuando abandonan la empresa
  • Otorgar acceso a una app cuando un usuario se une al equipo relevante

API de Voided Purchases

La API de Voided Purchases proporciona una lista de pedidos asociados con las compras que anuló un usuario. Puedes usar la información de esta lista a fin de implementar un sistema de revocación para evitar que un usuario acceda a los productos de esos pedidos.

Esta API se aplica a suscripciones de apps y pedidos únicos realizados directo desde apps.

Una compra se puede anular de las siguientes maneras:

  • Si el usuario solicita un reembolso por el pedido
  • Si el usuario cancela el pedido
  • Si se realiza la devolución del cargo del pedido
  • Si el desarrollador cancela o reembolsa el pedido (Nota: En la API de Voided Purchases, solo se mostrarán los pedidos revocados; si el desarrollador reembolsa el monto sin configurar la opción de revocación, los pedidos no aparecerán en la API)
  • Si Google cancela o reembolsa el pedido

Si usas esta API, estarás creando una experiencia más equilibrada y justa para los usuarios de tu app, especialmente si se trata de un juego.