Preparando…

Nota: Antes de leer este documento, asegúrate de leer la documentación del Centro de ayuda de Play Console, que describe conceptos fundamentales relacionados con la compra y cómo crear y configurar tus productos para la venta.

En este documento, se enumeran y describen los pasos de configuración que debes seguir antes de poder vender productos en tu app. En términos generales, esta configuración incluye crear una cuenta de desarrollador, crear y configurar los productos que quieres vender, y habilitar y configurar las APIs que usas para vender y administrar tus productos. En este documento, también se describe la configuración de las notificaciones para desarrolladores en tiempo real, de modo que estos últimos puedan recibirlas cuando cambia el estado de un producto.

Cómo configurar una cuenta de desarrollador de Google Play

Para publicar tus apps y juegos en Google Play, usa Google Play Console. También puedes usar Google Play Console para administrar los productos y la configuración relacionados con la facturación.

Para acceder a Google Play Console, debes configurar una cuenta de desarrollador de Google Play.

Para vender aplicaciones pagadas y compras directas desde la app en Google Play, también debes configurar un perfil en el centro de pagos de Google y, luego, vincular ese perfil a tu cuenta de desarrollador de Google Play. Para obtener información sobre cómo vincular tu perfil a tu cuenta o consultar cómo verificar si la cuenta y el perfil ya están vinculados, consulta Cómo vincular una cuenta de desarrollador de Google Play a tu perfil de pagos.

Cómo habilitar funciones relacionadas con la facturación en Google Play Console

Cuando hayas configurado una cuenta de desarrollador, deberás publicar una versión de tu app que incluya la Biblioteca de Facturación Google Play. Este paso es obligatorio para habilitar las funciones relacionadas con la facturación en Google Play Console, como la configuración de los productos que deseas vender.

Cómo agregar una dependencia de biblioteca

Para integrar el sistema de facturación de Google Play, primero agrega una dependencia a la Biblioteca de Facturación Google Play en tu app. Esta biblioteca proporciona acceso a las API de Android que te conectan con Google Play. Desde allí puedes acceder a la información de compras, consultar actualizaciones sobre compras, solicitar a un usuario que realice nuevas compras y más.

La Biblioteca de Facturación Google Play está disponible en el repositorio de Maven de Google. Agrega la dependencia al archivo build.gradle de tu app, como se muestra a continuación:

Groovy

dependencies {
    def billing_version = "9.1.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "9.1.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

Si usas Kotlin, el módulo KTX de la Biblioteca de Facturación Play es compatible con las extensiones y corrutinas de Kotlin, y permite la escritura de Kotlin cuando usas el sistema de facturación de Google Play. Para incluir estas extensiones en tu proyecto, agrega la siguiente dependencia al archivo build.gradle de la app como se muestra a continuación:

Groovy

dependencies {
    def billing_version = "9.1.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "9.1.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

Los ejemplos de código Kotlin que se encuentran en esta página aprovechan KTX cuando sea posible.

Cómo subir tu app

Una vez que hayas agregado la biblioteca a tu app, compílala y publícala. Para este paso, crea tu app y, luego, publícala en cualquier segmento, incluido el segmento de pruebas internas.

Nota: Las compras realizadas en apps publicadas en el segmento de pruebas internas o en etapa de borrador están sujetas a límites de compra.

Cómo crear y configurar tus productos

Después de habilitar las funciones de Facturación Google Play para tu app, debes configurar los productos que deseas vender.

Los pasos para crear suscripciones y productos únicos son similares. Para cada producto, debes proporcionar un ID de producto único, un título, una descripción y la información de precios. Las suscripciones tienen requisitos de información adicionales, por ejemplo, seleccionar si es un tipo de renovación prepaga o de renovación automática para el plan básico.

Google Play Console proporciona una interfaz web que puedes usar para administrar tus productos.

• Para crear y configurar productos únicos, consulta Cómo crear un producto administrado. Ten en cuenta que Google Play Console se refiere a los productos únicos como productos administrados.

• Para crear y configurar suscripciones, consulta Cómo crear una suscripción.

Como alternativa a la interfaz web, también puedes administrar tus productos con el recurso REST inappproducts para productos integrados en la aplicación y el recurso REST monetization.subscriptions para productos de suscripción en la API de Google Play Developer.

Cómo configurar la API de Google Play Developer

La API de Google Play Developer es una API de servidor a servidor que complementa la Biblioteca de Facturación Google Play en Android. Esta API proporciona funcionalidades que no están disponibles en la Biblioteca de Facturación Google Play, como la verificación segura de compras y la emisión de reembolsos a tus usuarios.

Como parte de la integración del sistema de facturación de Google Play en tu app, debes configurar el acceso a la API de Google Play Developer a través de Google Play Console. Para obtener instrucciones, consulta Cómo comenzar a usar la API de Google Play Developer.

Una vez que hayas configurado el acceso a la API de Google Play Developer, asegúrate de haber otorgado el permiso Ver los datos financieros, que se necesita para acceder a la funcionalidad relacionada con la facturación. Para obtener información sobre las prácticas recomendadas y más información sobre la configuración de permisos, consulta Cómo agregar usuarios a la cuenta de desarrollador y administrar permisos.

Cómo configurar notificaciones para desarrolladores en tiempo real

Las notificaciones para desarrolladores en tiempo real (RTDN) son un mecanismo para recibir notificaciones de Google cada vez que hay un cambio en el derecho de un usuario dentro de tu app. Las RTDN usan Google Cloud Pub/Sub, que te permite recibir datos que se envían a una URL que estableces o que se sondean con una biblioteca cliente. Estas notificaciones te permiten reaccionar de inmediato ante los cambios de estado de la suscripción, lo que evita la necesidad de consultar la API de Google Play Developer. Ten en cuenta que el uso ineficiente de la API de Google Play Developer puede generar restricciones de cuota de API.

Nota: Debes llamar a la API de Google Play Developer después de recibir notificaciones para desarrolladores en tiempo real para obtener el estado completo y actualizar tu propio estado de backend. Estas notificaciones solo indican que cambió el estado de la suscripción. No proporcionan información completa sobre la compra.

Cloud Pub/Sub es un servicio de mensajería en tiempo real completamente administrado que puedes usar para enviar y recibir mensajes entre aplicaciones independientes. Google Play usa Cloud Pub/Sub para publicar notificaciones push sobre temas a los que te suscribas.

Para recibir notificaciones, debes crear un servidor de backend a fin de consumir los mensajes enviados a tu tema. Luego, tu servidor puede consumir estos mensajes respondiendo a solicitudes HTTPS a un extremo registrado o usando las bibliotecas cliente de Cloud Pub/Sub. Estas bibliotecas están disponibles en varios lenguajes. También puedes encontrar más información en la sección Crea una suscripción a Pub/Sub de este documento.

Cómo determinar los precios y las cuotas

Para conocer detalles sobre los precios y las cuotas, consulta precios y cuotas.

Estima el uso de datos

La parte de datos de la notificación de suscripción es de aproximadamente 1 KB de datos por solicitud. Cada notificación de publicación o de extracción requiere una solicitud individual, o aproximadamente 2 KB de datos por notificación. La cantidad de notificaciones por mes depende del ciclo de facturación y del comportamiento de los usuarios. Debes esperar al menos una notificación por cada usuario durante un ciclo de facturación.

Configura Cloud Pub/Sub

Si deseas habilitar las notificaciones para desarrolladores en tiempo real, primero, debes configurar Cloud Pub/Sub con tu propio proyecto de Google Cloud y, luego, habilitar las notificaciones para tu app.

Para usar Cloud Pub/Sub, debes tener un proyecto de Google Cloud con la API de Cloud Pub/Sub habilitada. Si no estás familiarizado con Google Cloud y Cloud Pub/Sub, consulta la Guía de inicio rápido.

Nota: Debes configurar las notificaciones para desarrolladores en tiempo real de cada app para Android por separado. Esto significa que puedes elegir usar el mismo proyecto de Google Cloud que el que se usa para acceder a la API de Play Developer, o bien puedes crear un proyecto de Google Cloud nuevo para cada app. Si tienes varias apps, debes usar el mismo proyecto de la consola de Google Cloud para la API de Google Play Developer, pero puedes usar diferentes proyectos de la consola de Google Cloud para cada app individual.

Crea un tema

Para comenzar a recibir notificaciones, debes crear un tema en el que Google Play deba publicar las notificaciones. Para crear un tema, sigue las instrucciones que se indican en Crea el tema.

Cómo crear una suscripción de Pub/Sub

A fin de recibir mensajes publicados en un tema, debes crear una suscripción de Pub/Sub a ese tema. Para crear una suscripción de Pub/Sub, haz lo siguiente:

1. Lee la Guía para suscriptores de Cloud Pub/Sub para determinar si debes configurar la suscripción como una suscripción de envío o una suscripción de extracción.
   • Una suscripción push permite que Cloud Pub/Sub envíe notificaciones a tu backend seguro mediante el envío de solicitudes HTTPS.
   • Una suscripción de extracción requiere que el servidor de backend seguro inicie solicitudes en el servidor de Cloud Pub/Sub para recuperar mensajes.
2. Sigue las instrucciones que se indican en Cómo agregar una suscripción para crear una.

Nota: Las suscripciones de extracción se suelen usar con el objetivo de optimizar el uso de recursos cuando se procesa una gran cantidad de mensajes, que por lo general no se aplican a las RTDN. Si no estás seguro de si debes comenzar con suscripciones push o de extracción, te recomendamos que uses push, ya que, en general, es más fácil de implementar. Consulta Entrega de extracción o de envío para decidir si una suscripción de extracción o de envío es la mejor opción para tu app.

Cómo otorgar derechos de publicación en tu tema

Cloud Pub/Sub requiere que otorgues privilegios a Google Play para publicar notificaciones en tu tema.

1. Abre Google Cloud Console.
2. Selecciona tu proyecto y, luego, haz clic en Pub/Sub en el panel de navegación izquierdo.

3. Encuentra tu tema y abre los detalles de permisos.

   

   Figura 1: Accede a la configuración del tema Permisos

4. Agrega la cuenta de servicio [e-mail] y otórgale la función de publicador de Pub/Sub.

   

   Figura 2: Agrega la cuenta de servicio de Google Play como publicador de Pub/Sub

5. Haz clic en Guardar para completar la configuración del tema.

   

   Figura 3: Un tema configurado

Nota: Si la configuración de uso compartido restringido del dominio de tu organización te impide otorgar permisos de publicación, debes agregar una excepción para la cuenta de servicio de Google Play.

Cómo habilitar las notificaciones para desarrolladores en tiempo real para tu app

A fin de habilitar las notificaciones para desarrolladores en tiempo real de tu app, haz lo siguiente:

1. Abre Google Play Console.
2. Selecciona tu app.
3. Ve a Monetizar > Configuración de monetización.

4. Ve a la sección Notificaciones para desarrolladores en tiempo real que se encuentra en la parte superior de la página.

   

   Figura 4: Sección de notificaciones para desarrolladores en tiempo real

5. Selecciona Habilitar notificaciones en tiempo real.

6. En el campo Nombre del tema, ingresa el nombre completo del tema de Cloud Pub/Sub que configuraste antes. El nombre debe tener el formato projects/{project_id}/topics/{topic_name}, en el que project_id sea el identificador único de tu proyecto, y topic_name, el nombre del tema creado anteriormente.

7. Haz clic en Enviar mensaje de prueba a fin de enviar un mensaje de prueba. Realizar una publicación de prueba ayuda a garantizar que todo esté configurado de manera correcta. Si la publicación de prueba se realiza correctamente, se muestra un mensaje que indica que la publicación de prueba se realizó correctamente. Si adjuntaste una suscripción para este tema, deberías recibir el mensaje de prueba.

   Para obtener una suscripción de extracción, ve a la suscripción en Cloud Console, haz clic en Ver mensajes y, luego, extrae los mensajes. Debes confirmar cualquier mensaje que hayas extraído para evitar la entrega repetida de Cloud Pub/Sub. En el caso de una suscripción de envío, verifica si el mensaje de prueba se entrega a tu extremo de envío. Un código de respuesta correcto servirá como confirmación del mensaje.

   Si hay un error en la publicación, aparecerá un mensaje. Asegúrate de que el nombre del tema sea correcto y de que la cuenta de servicio [e-mail] tenga acceso como publicador de Pub/Sub al tema.

8. Elige qué tipos de notificaciones quieres recibir.

   • Recibir notificaciones de suscripciones y de todas las compras que se anularon: Recibe notificaciones para desarrolladores en tiempo real relacionadas con suscripciones y compras anuladas. No recibirás notificaciones sobre las compras de productos únicos.
   • Recibir todas las notificaciones de suscripciones y productos únicos: Recibe notificaciones de todos los eventos de suscripción y eventos de compra anulada. También recibirás eventos de compra de productos únicos, como ONE_TIME_PRODUCT_PURCHASED y ONE_TIME_PRODUCT_CANCELED. Consulta Ciclo de vida de compras únicas para obtener más información sobre estos eventos de compra.

9. Haz clic en Guardar cambios.

Cómo verificar tu configuración

A fin de recibir notificaciones para desarrolladores en tiempo real, debes crear un servidor de backend seguro que consuma los mensajes enviados a tu tema de Cloud Pub/Sub.

Puedes probar tu configuración con el botón Enviar mensaje de prueba en Google Play Console, como se describe en la sección anterior. Si no configuraste un servidor de backend para consumir notificaciones, puedes usar la herramienta de línea de comandos de gcloud para verificar la configuración. A fin de obtener instrucciones para procesar mensajes con gcloud, consulta Cómo extraer el mensaje de la suscripción.

Próximos pasos

• Integra la biblioteca en la app