Recordatorio: A partir del 2 de agosto de 2021, todas las apps nuevas deben usar la Biblioteca de Facturación 3 o versiones posteriores. A partir del 1 de noviembre de 2021, todas las actualizaciones de las apps existentes deben usar la Biblioteca de Facturación 3 o versiones posteriores. Obtén más información.

Preparación

En este tema se enumeran y describen los pasos de configuración que debes realizar antes de vender productos en tu app. En un nivel alto, esta configuración incluye la creación de una cuenta de desarrollador, la creación y la configuración de los productos que deseas vender y la habilitación y la configuración de las API que utilizas para vender y administrar tus productos. En este tema también se describe cómo configurar las notificaciones para que se notifique al desarrollador en tiempo real 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 tus configuraciones y productos de facturación.

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

Para vender apps pagas y compras directas desde la aplicación en Google Play, también debes configurar un perfil en el centro de pagos de Google y vincularlo 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 Maven de Google. Agrega la dependencia al archivo build.gradle de tu app como se muestra a continuación:

dependencies {
    def billing_version = "3.0.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:

dependencies {
    def billing_version = "3.0.0"

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

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 publícala en cualquier segmento, incluido el segmento de pruebas internas.

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 información adicional obligatoria, como el período de renovación, si ofreces una prueba gratuita y si la suscripción tiene una oferta de lanzamiento.

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

Como alternativa a la interfaz web, también puedes administrar tus productos mediante el recurso REST inappproducts 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 otorgar el permiso Ver datos financieros, necesario para acceder a la funcionalidad relacionada con la facturación. Para obtener información sobre las recomendaciones 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 que permite recibir notificaciones de Google cada vez que haya un cambio en la autorización de un usuario dentro de la app. RTDN aprovecha el uso de Google Cloud Pub/Sub, que te permite recibir datos que se envían a una URL que configuras o que se sondea mediante 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 para desarrolladores de Google Play. Ten en cuenta que el uso ineficiente de la API de Google Play Developer puede generar restricciones de cuota de API.

Cloud Pub/Sub es un servicio de mensajería en tiempo real completamente administrado que puedes usar a fin de enviar y recibir mensajes entre apps 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. Tu servidor puede consumir estos mensajes respondiendo a las solicitudes HTTPS a un extremo registrado o usando las bibliotecas cliente de Cloud Pub/Sub. Estas bibliotecas están disponibles en varios idiomas. También puedes encontrar más información en la sección Cómo crear una suscripción de Pub/Sub en este tema.

Cómo configurar 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 Platform (GCP) y, luego, habilitar las notificaciones en tu app.

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

Cómo crear un tema

Para empezar a recibir notificaciones, debes crear un tema en el que Google Play publique las notificaciones. Para crear un tema, sigue las instrucciones en Cómo crear 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 a fin de consultar si debes configurar la suscripción como una suscripción push o 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 obtener mensajes.
  2. Sigue las instrucciones de Cómo agregar una suscripción para crear una suscripción.

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

Cloud Pub/Sub requiere que otorgues privilegios de 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.

    acceso a la configuración del tema de permisos
    Figura 1: Accede a la configuración del tema Permisos
  4. Agrega la cuenta de servicio google-play-developer-notifications@system.gserviceaccount.com y otórgale la función de publicador de Pub/Sub.

    agrega la cuenta de servicio de Google Play como 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.

    un tema configurado
    Figura 3: Un tema configurado

Cómo habilitar las notificaciones para desarrolladores en tiempo real en 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 Herramientas de desarrollo > Servicios y API.
  4. Desplázate hasta la sección Notificaciones para desarrolladores en tiempo real, ubicada al final de la página.

    sección de notificaciones para desarrolladores en tiempo real
    Figura 4: Sección de notificaciones para desarrolladores en tiempo real
  5. 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.

  6. 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 es correcta, aparecerá un mensaje que lo indique. Si tienes un suscriptor para este tema, debería recibir el mensaje de prueba.

    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 google-play-developer-notifications@system.gserviceaccount.com tenga acceso como publicador de Pub/Sub al tema.

  7. Haz clic en Actualizar tema.

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 a fin de 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