Notas de la versión de la Biblioteca de Facturación Google Play

Aquí se incluyen las notas de la versión de la Biblioteca de Facturación Google Play.

Versión 2.0.3 de la Biblioteca de Facturación Google Play (05/08/2019)

Ya está disponible la versión 2.0.3 de la Biblioteca de Facturación Google Play.

Correcciones de errores

  • Se corrigió un error por el cual querySkuDetailsAsync() fallaba ocasionalmente y mostraba el código DEVELOPER_ERROR, en lugar de un resultado correcto.

Versión 2.0.2 de la Biblioteca de Facturación Google Play (08/07/2019)

Ya está disponible la versión 2.0.2 de la Biblioteca de Facturación Google Play. En ella, se incluyen actualizaciones de la documentación de referencia y no se modifica la funcionalidad de la biblioteca.

Versión 2.0.1 de la Biblioteca de Facturación Google Play (06/06/2019)

Ya está disponible la versión 2.0.1 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Correcciones de errores

  • Se corrigió un error por el que los mensajes de depuración se muestran como null en algunos casos.
  • Se corrigió un posible problema de fuga de memoria.

Versión 2.0 de la Biblioteca de Facturación Google Play (07/05/2019)

Ya está disponible la versión 2.0 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Las compras deben reconocerse en un plazo de tres días

Google Play admite la compra de productos desde adentro de la app (integrados en la aplicación) y fuera de ella. Para que Google Play garantice una experiencia de compra coherente, sin importar dónde compre tu producto el usuario, debes reconocer todas las compras recibidas mediante la Biblioteca de Facturación Google Play tan pronto como sea posible después de otorgar autorización al usuario. Si no reconoces una compra en un plazo de tres días, el usuario recibirá automáticamente un reembolso y Google Play revocará la compra. En el caso de las transacciones pendientes (novedad de la versión 2.0), el plazo de tres días comienza cuando la compra pasa al estado SUCCESS y no se aplica mientras está en estado PENDING.

Para las suscripciones, debes reconocer cualquier compra que tenga un token de compra nuevo. Eso quiere decir que todas las compras iniciales, los cambios de planes y registros nuevos de facturación deben reconocerse, pero no es necesario que reconozcas las renovaciones posteriores. Para determinar si es necesario reconocer una compra, puedes buscar el campo de reconocimiento en la compra.

El objeto Purchase ahora incluye un método isAcknowledged(), que indica si se reconoció una compra. Además, la API de desarrolladores de Google Play incluye valores booleanos de reconocimiento para Purchases.products y Purchases.subscriptions. Antes de confirmar una compra, asegúrate de usar estos métodos para determinar si ya se confirmó.

Para reconocer una compra, usa uno de los siguientes métodos:

  • En el caso de productos para usuarios finales, usa consumeAsync(), que se encuentra en la API del cliente.
  • En el caso de productos que no se consumen, usa acknowledgePurchase(), que se encuentra en la API del cliente.
  • También hay un método acknowledge() nuevo disponible en la API del servidor.

Se quitó la compatibilidad con BillingFlowParams.setSku()

En esta versión, se quitó el método BillingFlowParams#setSku() que previamente dejó de estar disponible. Antes de procesar productos en un flujo de compras, debes llamar a BillingClient.querySkuDetailsAsync() para transmitir el objeto SkuDetails resultante a BillingFlowParams.Builder.setSkuDetails().

Para ver ejemplos de código, consulta Cómo usar la Biblioteca de Facturación Google Play.

Se admite la carga útil de desarrollador

En la versión 2.0 de la Biblioteca de Facturación Google Play, se agregó compatibilidad con la carga útil de desarrolladores; strings arbitrarias que pueden adjuntarse a compras. Puedes adjuntar un parámetro de carga útil de desarrollador a una compra, pero solo cuando se reconoce o consume la compra. La carga útil de desarrollador en AIDL es distinta, ya que allí se puede especificar cuando se inicia el flujo de compra. Como ahora las compras pueden iniciarse desde afuera de tu app, este cambio garantiza que siempre tengas la oportunidad de agregar una carga útil a las compras.

Para acceder a la carga útil en la nueva biblioteca, los objetos Purchase ahora incluyen un método getDeveloperPayload().

Ofertas coherentes

Cuando ofrezcas un SKU con descuento, Google Play también mostrará el precio original del SKU para que puedas indicarles a los usuarios que están recibiendo un descuento.

SkuDetails incluye dos métodos nuevos para recuperar el precio original del SKU:

Transacciones pendientes

Con la versión 2.0 de la Biblioteca de Facturación Google Play, debes admitir compras en las que se requieren acciones adicionales antes de otorgar autorización. Por ejemplo, un usuario puede elegir comprar tu producto integrado en la aplicación en una tienda física con dinero en efectivo. Eso significa que la transacción se completa fuera de tu app. En ese escenario, deberías otorgar autorización solo después de que el usuario haya completado la transacción.

Para habilitar las compras pendientes, llama a enablePendingPurchases() como parte de la inicialización de la app.

Usa Purchase.getPurchaseState() para determinar si el estado de la compra es PURCHASED o PENDING. Ten en cuenta que debes otorgar autorización solo cuando el estado sea PURCHASED. Para consultar las actualizaciones de estado de Purchase, haz lo siguiente:

  1. Cuando inicies la app, llama a BillingClient.queryPurchases() para recuperar la lista de productos sin consumir asociados con el usuario.
  2. Llama a Purchase.getPurchaseState() en cada objeto Purchase que se muestra.
  3. Implementa el método onPurchasesUpdated() para responder a los cambios en los objetos Purchase.

Además, la API de desarrolladores de Google Play incluye un estado PENDING para Purchases.products. Las transacciones pendientes no son compatibles con las suscripciones.

En esta versión, también se presenta un nuevo tipo de notificación de desarrollador en tiempo real: OneTimeProductNotification. Este tipo de notificación incluye un único mensaje cuyo valor es INAPP_PURCHASED o INAPP_CANCELED. Este tipo de notificación se envía solo para compras asociadas con formas de pago demoradas, como efectivo.

Cuando reconozcas compras pendientes, asegúrate de hacerlo solo cuando el estado de la compra sea SUCCESS y no PENDING.

Cambios en la API

La versión 2.0 de la Biblioteca de Facturación Google Play incluye varios cambios en la API para admitir funciones nuevas y explicar funciones existentes.

consumeAsync

consumeAsync() ahora incluye un objeto ConsumeParams, en lugar de un purchaseToken. ConsumeParams contiene el purchaseToken, además de una carga útil de desarrollador opcional.

Ya no se incluye la versión anterior de consumeAsync().

queryPurchaseHistoryAsync

Para minimizar la confusión, queryPurchaseHistoryAsync() ahora muestra un objeto PurchaseHistoryRecord, en lugar de Purchase. El objeto PurchaseHistoryRecord coincide con Purchase, salvo porque solo refleja los valores que muestra queryPurchaseHistoryAsync() y no incluye los campos autoRenewing, orderId ni packageName. Ten en cuenta que no hay ningún cambio en los datos resultantes; queryPurchaseHistoryAsync() muestra los mismos datos que antes.

Valores resultantes de BillingResult

Las API que solían mostrar un valor entero BillingResponse ahora muestran un objeto BillingResult. BillingResult incluye el número entero BillingResponse, además de una string de depuración que puedes usar para diagnosticar errores. La string de depuración usa una configuración regional "en-US" y no está pensada para mostrarse a usuarios finales.

Correcciones de errores

Versión 1.2.2 de la Biblioteca de Facturación Google Play (07/03/2019)

Ya está disponible la versión 1.2.2 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Correcciones de errores

  • Se corrigió un problema relacionado con los subprocesos que se introdujo en la versión 1.2.1. Las llamadas en segundo plano ya no bloquean el subproceso principal.

Otros cambios

  • Aunque todavía se recomienda usar el subproceso principal, ahora puedes crear una instancia de la Biblioteca de Facturación Google Play desde un subproceso en segundo plano.
  • La creación de instancias se migró por completo al subproceso en segundo plano para reducir las probabilidades de provocar un ANR.

Versión 1.2.1 de la Biblioteca de Facturación Google Play (04/03/2019)

Ya está disponible la versión 1.2.1 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Cambios relevantes

Otros cambios

  • Se agregaron constructores públicos para PurchasesResult y SkuDetailsResult para facilitar la ejecución de pruebas.
  • Los objetos SkuDetails pueden usar un método nuevo, getOriginalJson().
  • Ahora, los subprocesos en segundo plano manejan todas las llamadas de servicio de AIDL.

Correcciones de errores

  • Los objetos de escucha de devolución de llamadas nulos ya no se pasan a API públicas.

Versión 1.2 de la Biblioteca de Facturación Google Play (18/10/2018)

Ya está disponible la versión 1.2 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Resumen de cambios

  • La Biblioteca de Facturación Google Play ahora cuenta con la licencia del Acuerdo de licencia del kit para desarrollo de software de Android.
  • Se agregó la API launchPriceChangeConfirmationFlow, que les indica a los usuarios que revisen un cambio pendiente en un precio de suscripción.
  • Se agregó compatibilidad con un nuevo modo de prorrateo, DEFERRED, cuando se actualiza la suscripción de un usuario o se pasa a la versión anterior de esta.
  • En la clase BillingFlowParams, se reemplazó setSku() con setSkuDetails().
  • Se corrigieron errores menores y se optimizó el código.

Confirmación de cambio de precio

Ahora, puedes cambiar el precio de una suscripción en Google Play Console y pedirles a los usuarios que revisen y acepten el precio nuevo cuando entran a la app.

Para usar esta API, crea un objeto PriceChangeFlowParams usando el skuDetails del producto de suscripción y, luego, llama a launchPriceChangeConfirmationFlow(). Implementa el PriceChangeConfirmationListener para controlar el resultado cuando finalice el flujo de confirmación de cambio de precio, como se muestra en el siguiente fragmento de código:

Kotlin

val priceChangeFlowParams = PriceChangeFlowParams.newBuilder()
    .setSkuDetails(skuDetailsOfThePriceChangedSubscription)
    .build()

billingClient.launchPriceChangeConfirmationFlow(activity,
        priceChangeFlowParams,
        object : PriceChangeConfirmationListener() {
            override fun onPriceChangeConfirmationResult(responseCode: Int) {
                // Handle the result.
            }
        })

Java

PriceChangeFlowParams priceChangeFlowParams =
        PriceChangeFlowParams.newBuilder()
    .setSkuDetails(skuDetailsOfThePriceChangedSubscription)
    .build();

billingClient.launchPriceChangeConfirmationFlow(activity,
        priceChangeFlowParams,
        new PriceChangeConfirmationListener() {
            @Override
            public void onPriceChangeConfirmationResult(int responseCode) {
                // Handle the result.
            }
        });

El flujo de confirmación de cambio de precio muestra un cuadro de diálogo con la información del precio nuevo, además de solicitar a los usuarios que lo acepten. Este flujo muestra un código de respuesta del tipo BillingClient.BillingResponse.

Nuevo modo de prorrateo

Al actualizar la suscripción de un usuario o pasar a una versión anterior de esta, puedes usar un modo de prorrateo nuevo, DEFERRED. Con este modo, la suscripción del usuario se actualiza cuando se vuelve a renovar. Para obtener más información sobre cómo configurar este modo de prorrateo, consulta Cómo configurar el modo de prorrateo.

Nuevo método para configurar la información de SKU

En la clase BillingFlowParams, dejó de estar disponible el método setSku(). El objetivo de ese cambio es optimizar el flujo de la Facturación Google Play.

Cuando construyas una instancia nueva de BillingFlowParams en tu cliente de facturación integrada, te recomendamos que, en su lugar, trabajes con el objeto JSON usando directamente setSkuDetails(), como se muestra en el siguiente fragmento de código:

En la clase de generador BillingFlowParams, dejó de estar disponible el método setSku(). En su lugar, usa el método setSkuDetails(), como se muestra en el siguiente fragmento de código. El objeto que se transmitió a setSkuDetails() proviene del método querySkuDetailsAsync().

Kotlin

private lateinit var mBillingClient: BillingClient
private val mSkuDetailsMap = HashMap<String, SkuDetails>()

private fun querySkuDetails() {
    val skuDetailsParamsBuilder = SkuDetailsParams.newBuilder()
    mBillingClient.querySkuDetailsAsync(skuDetailsParamsBuilder.build()
    ) { responseCode, skuDetailsList ->
        if (responseCode == 0) {
            for (skuDetails in skuDetailsList) {
                mSkuDetailsMap[skuDetails.sku] = skuDetails
            }
        }
    }
}

private fun startPurchase(skuId: String) {
    val billingFlowParams = BillingFlowParams.newBuilder()
    .setSkuDetails(mSkuDetailsMap[skuId])
    .build()
}

Java

private BillingClient mBillingClient;
private Map<String, SkuDetails> mSkuDetailsMap = new HashMap<>();

private void querySkuDetails() {
    SkuDetailsParams.Builder skuDetailsParamsBuilder
            = SkuDetailsParams.newBuilder();
    mBillingClient.querySkuDetailsAsync(skuDetailsParamsBuilder.build(),
            new SkuDetailsResponseListener() {
                @Override
                public void onSkuDetailsResponse(int responseCode,
                        List<SkuDetails> skuDetailsList) {
                    if (responseCode == 0) {
                        for (SkuDetails skuDetails : skuDetailsList) {
                            mSkuDetailsMap.put(skuDetails.getSku(), skuDetails);
                        }
                    }
                }
            });
}

private void startPurchase(String skuId) {
    BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
            .setSkuDetails(mSkuDetailsMap.get(skuId))
            .build();
}

Versión 1.1 de la Biblioteca de Facturación Google Play (07/05/2018)

Ya está disponible la versión 1.1 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Resumen de cambios

  • Se agregó compatibilidad para especificar un modo de prorrateo en BillingFlowParams cuando se actualiza una suscripción existente o se vuelve a la versión anterior de esta.
  • Ya no se admite el indicador booleano replaceSkusProration en BillingFlowParams. En su lugar, usa replaceSkusProrationMode.
  • launchBillingFlow() ahora activa una devolución de llamada para respuestas con errores.

Cambios en el comportamiento

En la versión 1.1 de la Biblioteca de Facturación Google Play, se incluyen los siguientes cambios de comportamiento.

Los desarrolladores pueden configurar replaceSkusProrationMode en la clase BillingFlowParams

Un ProrationMode proporciona más detalles sobre el tipo de prorrateo cuando se actualiza la suscripción de un usuario o se pasa a la versión anterior de esta.

Kotlin

BillingFlowParams.newBuilder()
    .setSku(skuId)
    .setType(billingType)
    .setOldSku(oldSku)
    .setReplaceSkusProrationMode(replaceSkusProrationMode)
    .build()

Java

BillingFlowParams.newBuilder()
    .setSku(skuId)
    .setType(billingType)
    .setOldSku(oldSku)
    .setReplaceSkusProrationMode(replaceSkusProrationMode)
    .build();

En la actualidad, Google Play admite los siguientes modos de prorrateo:

IMMEDIATE_WITH_TIME_PRORATION El reemplazo se realiza de inmediato y la nueva hora de vencimiento se prorratea y se acredita, o bien se le cobra al usuario. Actualmente, este es el comportamiento predeterminado.
IMMEDIATE_AND_CHARGE_PRORATED_PRICE El reemplazo se realiza inmediatamente y el ciclo de facturación no cambia. Se cobrará el precio del período restante.

Nota: Esta opción solo está disponible para la actualización de suscripciones.

IMMEDIATE_WITHOUT_PRORATION El reemplazo se realiza inmediatamente y el nuevo precio se cobra cuando vuelve a aparecer la suscripción. El ciclo de facturación no cambia.

Ya no se admite replaceSkusProration en la clase BillingFlowParams

Antes, los desarrolladores podían establecer un indicador booleano para cobrar un monto prorrateado de una solicitud de actualización de suscripción. Como ahora se admite ProrationMode, que contiene una instrucción de prorrateo más detallada, este indicador booleano ya no es compatible.

launchBillingFlow() ahora activa una devolución de llamada para respuestas con errores

La Biblioteca de Facturación siempre activará la devolución de llamada PurhcasesUpdatedListener y mostrará un objeto BillingResponse de manera asíncrona. También se conservará el valor síncrono resultante de BillingResponse.

Correcciones de errores

  • Cuando el servicio se desconecta, sale como corresponde de manera anticipada en métodos asíncronos.
  • Los objetos de parámetro Builder ya no modifican objetos creados.
  • Problema 68087141: launchBillingFlow() ahora activa la devolución de llamada para respuestas con errores.

Versión 1.0 de la Biblioteca de Facturación Google Play (19/09/2017, anuncio)

Ya está disponible la versión 1.0 de la Biblioteca de Facturación Google Play. Esta versión incluye los siguientes cambios.

Cambios importantes

  • Se incorporó el permiso de facturación en el manifiesto de la biblioteca. Ya no es necesario agregar el permiso com.android.vending.BILLING en el manifiesto de Android.
  • Se agregó un compilador nuevo a la clase BillingClient.Builder.
  • Se introdujo un patrón de compilador para la clase SkuDetailsParams que debe usarse en los métodos de búsqueda de SKU.
  • Se actualizaron varios métodos de API para una mayor coherencia (los mismos nombres y ordenamientos de argumentos de retorno).

Cambios en el comportamiento

La versión 1.0 de la Biblioteca de Facturación Google Play incluye los siguientes cambios de comportamiento.

Clase BillingClient.Builder

BillingClient.Builder ahora se inicializa mediante el patrón newBuilder:

Kotlin

billingClient = BillingClient.newBuilder(context).setListener(this).build()

Java

billingClient = BillingClient.newBuilder(context).setListener(this).build();

Ahora el método launchBillingFlow se llama con una clase BillingFlowParams

Para iniciar el flujo de facturación de una compra o suscripción, el método launchBillingFlow() recibe una instancia BillingFlowParams inicializada con parámetros específicos de la solicitud:

Kotlin

BillingFlowParams.newBuilder().setSku(skuId)
        .setType(billingType)
        .setOldSku(oldSku)
        .build()

// Then, use the BillingFlowParams to start the purchase flow
val responseCode = billingClient.launchBillingFlow(builder.build())

Java

BillingFlowParams.newBuilder().setSku(skuId)
                              .setType(billingType)
                              .setOldSku(oldSku)
                              .build();

// Then, use the BillingFlowParams to start the purchase flow
int responseCode = billingClient.launchBillingFlow(builder.build());

Hay una nueva forma de buscar productos disponibles

Se unieron los argumentos de los métodos queryPurchaseHistoryAsync() y querySkuDetailsAsync() en un patrón de compilador:

Kotlin

val params = SkuDetailsParams.newBuilder()
params.setSkusList(skuList)
        .setType(itemType)
billingClient.querySkuDetailsAsync(params.build(), object : SkuDetailsResponseListener() {
    ...
})

Java

SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList)
        .setType(itemType);
billingClient.querySkuDetailsAsync(params.build(), new SkuDetailsResponseListener() {...})

El resultado ahora se obtiene mediante un código de resultado y una lista de objetos SkuDetails, en lugar de la clase encapsuladora anterior, para tu conveniencia y a fin de mantener la coherencia en nuestra API:

Kotlin

fun onSkuDetailsResponse(@BillingResponse responseCode: Int, skuDetailsList: List<SkuDetails>)

Java

public void onSkuDetailsResponse(@BillingResponse int responseCode, List<SkuDetails> skuDetailsList)

Se cambió el orden de los parámetros en el método onConsumeResponse()

Se cambió el orden de los argumentos de onConsumeResponse en la interfaz ConsumeResponseListener a fin de mantener la coherencia en nuestra API:

Kotlin

fun onConsumeResponse(@BillingResponse responseCode: Int, outToken: String)

Java

public void onConsumeResponse(@BillingResponse int responseCode, String outToken)

Se desencapsuló el objeto PurchaseResult

Se desencapsuló el objeto PurchaseResult a fin de mantener la coherencia en nuestra API:

Kotlin

fun onPurchaseHistoryResponse(@BillingResponse responseCode: Int, purchasesList: List<Purchase>)

Java

void onPurchaseHistoryResponse(@BillingResponse int responseCode, List<Purchase> purchasesList)

Correcciones de errores

Lanzamiento de Developer Preview 1 (12/06/2017, anuncio)

Se lanzó Developer Preview con el objetivo de simplificar el proceso de desarrollo en lo relacionado con la facturación, lo que les permitirá a los desarrolladores enfocarse en implementar lógica específica de la app de Android, como la estructura de navegación y la arquitectura de la aplicación.

La biblioteca incluye varias clases y funciones convenientes para que las aproveches cuando integras apps para Android con la API de Facturación Google Play. En la biblioteca también se incluye una capa de abstracción sobre el servicio del Lenguaje de definición de la interfaz de Android (AIDL), lo que les facilitará a los desarrolladores la definición de la interfaz entre la app y la API de Facturación Google Play.