Note di rilascio della Libreria Fatturazione Google Play

Questo documento contiene le note di rilascio per la libreria Fatturazione Google Play.

Rilascio della libreria Fatturazione Google Play 8.1.0 (06/11/2025)

Sono ora disponibili la versione 8.1.0 della libreria Google Play Billing Library e le estensioni Kotlin.

Riepilogo delle modifiche

• Abbonamenti sospesi

  È stato aggiunto un nuovo parametro al metodo BillingClient.queryPurchasesAsync() per includere gli abbonamenti sospesi durante l'esecuzione di query sugli abbonamenti. Gli abbonamenti sospesi vengono comunque attribuiti all'utente, ma non sono attivi, perché l'utente ha messo in pausa l'abbonamento o il metodo di pagamento per il rinnovo è stato rifiutato.

  L'oggetto Purchase restituito nel listener restituirà isSuspended() = true per tutti gli abbonamenti sospesi. In questo caso, non devi concedere l'accesso all'abbonamento acquistato e devi invece indirizzare l'utente al centro abbonamenti dove può gestire i metodi di pagamento o lo stato di pausa per riattivare l'abbonamento.

• Aggiornamenti agli abbonamenti:

  • L'oggetto BillingFlowParams.ProductDetailsParams ora ha il metodo setSubscriptionProductReplacementParams() in cui puoi specificare le informazioni di sostituzione a livello di prodotto.

  • L'oggetto SubscriptionProductReplacementParams ha due metodi setter:

    • setOldProductId: Il vecchio prodotto che deve essere sostituito dal prodotto nell'attuale ProductDetails.
    • setReplacementMode: Questa è la modalità di sostituzione a livello di articolo. Le modalità sono essenzialmente le stesse di SubscriptionUpdateParams, ma la mappatura dei valori è stata aggiornata. È stata introdotta una nuova modalità di sostituzione KEEP_EXISTING che ti consente di mantenere invariato il programma di pagamento esistente per un articolo.

  • SubscriptionUpdateParams setSubscriptionReplacementMode verrà ritirato. Dovresti usare invece SubscriptionProductReplacementParams.setReplacementMode.

• Aggiornamento di minSdkVersion alla versione 23.

• Sono state abilitate le API per la prenotazione per i prodotti a pagamento singolo

  L'API ProductDetails.oneTimePurchaseOfferDetails.getPreorderDetails() che recupera i dettagli della prenotazione è ora disponibile per l'utilizzo.

• La libreria Fatturazione Google Play ora supporta Kotlin versione 2.2.0.

Rilascio della libreria Fatturazione Google Play 8.0.0 (30/06/2025)

Sono ora disponibili la versione 8.0.0 della Libreria Fatturazione Google Play e le estensioni Kotlin.

Riepilogo delle modifiche

• Gli articoli in-app ora verranno chiamati prodotti a pagamento singolo.

• Più opzioni di acquisto e offerte per i prodotti a pagamento singolo.

  Ora puoi avere più opzioni di acquisto e offerte per i tuoi prodotti a pagamento singolo. In questo modo hai flessibilità nella vendita dei tuoi prodotti e riduci la complessità della loro gestione.

• È stato migliorato il metodo queryProductDetailsAsync().

  Prima di PBL 8.0.0, il metodo queryProductDetailsAsync() non restituiva i prodotti che non potevano essere recuperati. Ciò potrebbe essere dovuto a motivi quali il prodotto non è stato trovato o non sono disponibili offerte per l'utente. Con PBL 8.0.0, i prodotti non recuperati vengono restituiti con un nuovo codice di stato a livello di prodotto che fornisce informazioni sui prodotti non recuperati. Tieni presente che è stata modificata la firma di ProductDetailsResponseListener.onProductDetailsResponse(), il che richiede modifiche alla tua app. Per ulteriori informazioni, consulta Elaborare il risultato.

• Riconnessione automatica del servizio.

  Il nuovo parametro BillingClient.Builder.enableAutoServiceReconnection() builder consente agli sviluppatori di attivare la riconnessione automatica del servizio, che semplifica la gestione delle connessioni gestendo automaticamente le riconnessioni al servizio di fatturazione Google Play ed eliminando la necessità di chiamare manualmente startConnection() in caso di disconnessione del servizio. Per saperne di più, vedi Ristabilire automaticamente una connessione.

• Codici di risposta secondari per il metodo launchBillingFlow().

  Il valore BillingResult restituito da launchBillingFlow() ora include un campo del codice di risposta secondario. Questo campo verrà compilato solo in alcuni casi per fornire un motivo più specifico del mancato caricamento. Con PBL 8.0.0, viene restituito un codice secondario PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS nel caso in cui i fondi dell'utente siano inferiori al prezzo dell'articolo che sta tentando di acquistare.

• È stato rimosso il metodo queryPurchaseHistory().

  Il metodo queryPurchaseHistory() precedentemente contrassegnato come obsoleto è stato rimosso. Consulta Query Purchase History per informazioni dettagliate sulle API alternative da utilizzare.

• È stato rimosso il metodo querySkuDetailsAsync().

  Il metodo querySkuDetailsAsync() precedentemente contrassegnato come deprecato è stato rimosso. Devi utilizzare invece queryProductDetailsAsync.

• È stato rimosso il metodo BillingClient.Builder.enablePendingPurchases().

  Il metodo enablePendingPurchases() senza parametri precedentemente contrassegnato come deprecato è stato rimosso. Dovresti usare enablePendingPurchases(PendingPurchaseParams params). Tieni presente che il valore enablePendingPurchases() deprecato è funzionalmente equivalente a enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).

• È stato rimosso il metodo queryPurchasesAsync() sovraccarico che accetta un skuType.

  Il metodo queryPurchasesAsync(String skuType, PurchasesResponseListener listener) precedentemente contrassegnato come obsoleto è stato rimosso. In alternativa, utilizza queryPurchasesAsync(QueryPurchasesParams queryPurchasesParams, PurchasesResponseListener listener).

Rilascio della libreria Fatturazione Google Play 7.1.1 (3/10/2024)

Le versioni 7.1.1 della Libreria Fatturazione Google Play e delle estensioni Kotlin sono ora disponibili.

Correzioni di bug

• È stato corretto un bug nella Libreria Fatturazione Play 7.1.0 relativo ai codici di risposta BillingResult dei test.

Rilascio della libreria Fatturazione Google Play 7.1.0 (19/09/2024)

Sono ora disponibili la versione 7.1.0 della Libreria Fatturazione Google Play e le estensioni Kotlin.

Riepilogo delle modifiche

• Maggiore sicurezza dei thread relativa allo stato e alla gestione della connessione.
• Sono state introdotte modifiche parziali per i codici di risposta [BillingResult][billing-result] per i test, che verranno rilasciati completamente nella Libreria Fatturazione Play 7.1.1. Per testare l'integrazione utilizzando questa funzionalità, devi eseguire l'upgrade alla Libreria Fatturazione Play 7.1.1. Esiste un bug che influisce solo sulle applicazioni con [test di override della fatturazione abilitato][enable-billing-overrides-testing] e non influisce sull'utilizzo normale. Per maggiori informazioni, consulta Testa i codici di risposta BillingResult. [billing-result]: /reference/com/android/billingclient/api/BillingResult [enable-billing-overrides-testing]: /google/play/billing/test-response-codes#enable-billing-overrides-testing

Rilascio della libreria Fatturazione Google Play 7.0.0 (14/05/2024)

La versione 7.0.0 della Libreria Fatturazione Google Play e le estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

• Sono state aggiunte API per supportare gli abbonamenti a rate.

  • È stato aggiunto [ProductDetails.InstallmentPlanDetails][installment-details] per i piani base a rate che gli utenti possono acquistare. Questa API aiuta la tua app a identificare il piano rateale e la sua configurazione dell'impegno per fornire informazioni correlate all'utente. Per saperne di più, consulta la nostra [guida alle rate degli abbonamenti][installments]. [installment-details]: /reference/com/android/billingclient/api/ProductDetails.InstallmentPlanDetails [installments]: /google/play/billing/subscriptions#installments

• Sono stati aggiunti PendingPurchasesParams e BillingClient.Builder.enablePendingPurchases(PendingPurchaseParams) in sostituzione di BillingClient.Builder.enablePendingPurchases(), che è stato ritirato in questa release.

  • enablePendingPurchases() deprecato è funzionalmente equivalente a enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).

• Sono state aggiunte API per supportare le transazioni in sospeso per i piani prepagati in abbonamento:

  • Utilizza PendingPurchasesParams.Builder.enablePrepaidPlans() insieme a BillingClient.Builder.enablePendingPurchases(PendingPurchaseParams) per attivare le transazioni in attesa per i piani prepagati in abbonamento. Quando aggiungi l'assistenza, assicurati che la tua app gestisca correttamente anche i cicli di vita degli abbonamenti. Per saperne di più, consulta la nostra guida agli acquisti in attesa.
  • Sono stati aggiunti Purchase.PendingPurchaseUpdate e Purchase.getPendingPurchaseUpdate() per recuperare la ricarica, l'upgrade o il downgrade in attesa a un abbonamento esistente.

• Rimossi BillingClient.Builder.enableAlternativeBilling(), AlternativeBillingListener e AlternativeChoiceDetails .

  • Gli sviluppatori devono utilizzare BillingClient.Builder.enableUserChoiceBilling() con UserChoiceBillingListener e UserChoiceDetails nel callback del listener invece.

• BillingFlowParams.ProrationMode,BillingFlowParams.SubscriptionUpdateParams.Builder.setReplaceProrationMode() eBillingFlowParams.SubscriptionUpdateParams.Builder.setReplaceSkusProrationMode() rimossi. - Gli sviluppatori devono utilizzare BillingFlowParams.SubscriptionUpdateParams.ReplacementMode con BillingFlowParams.SubscriptionUpdateParams.Builder#setSubscriptionReplacementMode(int) invece. - BillingFlowParams.SubscriptionUpdateParams.Builder.setReplaceProrationMode(). - BillingFlowParams.SubscriptionUpdateParams.Builder.setReplaceSkusProrationMode().

• Rimosso BillingFlowParams.SubscriptionUpdateParams.Builder#setOldSkuPurchaseToken(). - Gli sviluppatori devono utilizzare BillingFlowParams.SubscriptionUpdateParams.Builder#setOldPurchaseToken(java.lang.String) invece.

• BillingClient.queryPurchaseHistoryAsync() è stato ritirato e verrà rimosso in una release futura. Gli sviluppatori devono utilizzare le seguenti alternative:

  • Acquisti riconosciuti e in attesa: utilizza BillingClient.queryPurchasesAsync() per recuperare gli acquisti attivi.
  • Acquisti consumati: gli sviluppatori devono tenere traccia degli acquisti consumati sui propri server.
  • Acquisti annullati: utilizza l'API per sviluppatori voided-purchases.
  • Per maggiori dettagli, vedi Query sulla cronologia acquisti.

• BillingFlowParams.ProductDetailsParams.setOfferToken() ora genera un'eccezione quando gli sviluppatori specificano un offerToken vuoto.

• minSdkVersion è stato aggiornato a 21 e targetSdkVersion a 34.

Rilascio della libreria Fatturazione Google Play 6.2.1 (16/04/2024)

Le versioni 6.2.1 della Libreria Fatturazione Google Play e delle estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

• È stato corretto un bug in BillingClient.showAlternativeBillingOnlyInformationDialog() in cui AlternativeBillingOnlyInformationDialogListener potrebbe non essere chiamato in alcuni casi al termine della finestra di dialogo.

Rilascio della libreria Fatturazione Google Play 6.2.0 (6/03/2024)

La versione 6.2.0 della Libreria Fatturazione Google Play e le estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

• Sono state aggiunte API per supportare le offerte esterne
  • Aggiunta BillingClient.Builder.enableExternalOffer() per consentire la possibilità di fornire offerte esterne.
  • È stato aggiunto BillingClient.isExternalOfferAvailableAsync() per verificare la disponibilità della funzionalità di fornitura di offerte esterne.
  • Aggiunta BillingClient.showExternalOfferInformationDialog() per mostrare agli utenti una finestra di dialogo informativa prima di indirizzarli all'esterno dell'app.
  • Aggiunto BillingClient.createExternalOfferReportingDetailsAsync() per creare un payload necessario per segnalare le transazioni effettuate tramite offerte esterne.

Rilascio della libreria Fatturazione Google Play 6.1.0 (14/11/2023)

Le versioni 6.1.0 della Libreria Fatturazione Google Play e delle estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

• Sono state aggiunte API per supportare la fatturazione alternativa solo (ovvero senza scelta dell'utente)
  • Aggiunta BillingClient.Builder.enableAlternativeBillingOnly() per attivare funzionalmente la possibilità di offrire solo la fatturazione alternativa.
  • Aggiunta BillingClient.isAlternativeBillingOnlyAvailableAsync() per verificare la disponibilità dell'offerta di fatturazione alternativa.
  • Aggiunta BillingClient.showAlternativeBillingOnlyInformationDialog() per mostrare una finestra di dialogo informativa per comunicare agli utenti quando viene utilizzata solo la fatturazione alternativa.
  • Aggiunta BillingClient.createAlternativeBillingOnlyReportingDetailsAsync() per creare un payload necessario per segnalare le transazioni effettuate solo tramite fatturazione alternativa.
• Aggiornamento delle API di fatturazione scelta dall'utente
  • È stato aggiunto UserChoiceBillingListener in sostituzione di AlternativeBillingListener che è stato contrassegnato come ritirato.
  • È stato aggiunto UserChoiceDetails per sostituire AlternativeChoiceDetails che è stato contrassegnato come ritirato.
  • Aggiunta BillingClient.Builder.enableUserChoiceBilling() per sostituire BillingClient.Builder.enableAlternativeBilling() che è stato contrassegnato come ritirato.
• Aggiunto BillingClient.getBillingConfigAsync() per recuperare il paese di Google Play.

Rilascio della libreria Fatturazione Google Play 6.0.1 (22/06/2023)

Le versioni 6.0.1 di Libreria Fatturazione Google Play e delle estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

Aggiorna Libreria Fatturazione Play per renderla compatibile con Android 14.

Rilascio della libreria Fatturazione Google Play 6.0 (10/05/2023)

La versione 6.0.0 della Libreria Fatturazione Google Play e le estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

• Aggiunta una nuova enumerazione ReplacementMode per sostituire ProrationMode.

  Tieni presente che ProrationMode è ancora disponibile per motivi di compatibilità con le versioni precedenti.

• ID ordine rimosso per gli acquisti di PENDING.

  In precedenza, l'ID ordine veniva sempre creato anche se l'acquisto era in attesa. A partire dalla versione 6.0.0, non verrà creato un ID ordine per gli acquisti in attesa e, per questi acquisti, l'ID ordine verrà compilato dopo che l'acquisto sarà passato allo stato PURCHASED.

• Sono stati rimossi i metodi queryPurchases e launchPriceConfirmationFlow.

  I metodi queryPurchases e launchPriceConfirmationFlow precedentemente contrassegnati come deprecati sono stati rimossi nella libreria Play Billing 6.0.0. Gli sviluppatori devono utilizzare queryPurchasesAsync anziché queryPurchases. Per le alternative a launchPriceConfirmationFlow, vedi Variazioni di prezzo.

• È stato aggiunto un nuovo codice di risposta di errore di rete.

  A partire dalla versione 6.0.0 della Libreria Fatturazione Play è stato aggiunto un nuovo codice di risposta di errore di rete, NETWORK_ERROR. Questo codice viene restituito quando si verifica un errore a causa di un problema di connessione di rete. Questi errori di connessione di rete sono stati segnalati in precedenza come SERVICE_UNAVAILABLE.

• Aggiornamento di SERVICE_UNAVAILABLE e SERVICE_TIMEOUT.

  A partire dalla versione 6.0.0 di PBL, gli errori dovuti al timeout durante l'elaborazione verranno restituiti come SERVICE_UNAVAILABLE anziché come SERVICE_TIMEOUT.

  Il comportamento non cambia nelle versioni precedenti di PBL.

• Rimosso SERVICE_TIMEOUT.

  A partire dalla versione 6.0.0 di PBL, SERVICE_TIMEOUT non verrà più restituito. Le versioni precedenti della Libreria Fatturazione Play continueranno a restituire questo codice.

• Aggiunto logging aggiuntivo.

  La release della libreria Google Play Billing 6 include la registrazione aggiuntiva, che fornisce informazioni sull'utilizzo dell'API (ad esempio esito positivo e negativo) e sui problemi di connessione al servizio. Queste informazioni verranno utilizzate per migliorare il rendimento della libreria Google Play Billing e fornire un supporto migliore per gli errori.

Rilascio della libreria Fatturazione Google Play 5.2.1 (22/06/2023)

Le versioni 5.2.1 della Libreria Fatturazione Google Play e delle estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

Aggiorna Libreria Fatturazione Play per renderla compatibile con Android 14.

Rilascio della libreria Fatturazione Google Play 5.2 (6/04/2023)

Le versioni 5.2.0 della Libreria Fatturazione Google Play e delle estensioni Kotlin sono ora disponibili.

Riepilogo delle modifiche

• Sono state aggiunte classi per supportare flussi di fatturazione alternativi su dispositivi mobili/tablet per gli utenti in Corea del Sud:
  • AlternativeBillingListener
  • AlternativeChoiceDetails
  • AlternativeChoiceDetails.Product
• È stato aggiunto il metodo BillingFlowParams.SubscriptionUpdateParams.Builder.setOriginalExternalTransactionId() per specificare l'ID transazione esterno dell'abbonamento di origine.
• Aggiunto il metodo BillingClient.Builder.enableAlternativeBilling() per consentire agli utenti in Corea del Sud di selezionare un'opzione di fatturazione alternativa.

Rilascio della libreria Fatturazione Google Play 5.1 (31/10/2022)

Sono ora disponibili la versione 5.1.0 della Libreria Fatturazione Google Play e le estensioni Kotlin.

Questa versione contiene le seguenti modifiche.

Riepilogo delle modifiche

• Aggiunto il metodo ProductDetails.SubscriptionOfferDetails.getOfferId() per recuperare l'ID offerta.
• Aggiunto il metodo ProductDetails.SubscriptionOfferDetails.getBasePlanId() per recuperare l'ID piano base.
• Aggiornamento del targetSdkVersion al 31.

Rilascio della libreria Fatturazione Google Play 5.0 (11/05/2022)

La versione 5.0.0 della Libreria Fatturazione Google Play e le estensioni Kotlin sono ora disponibili.

Questa versione contiene le seguenti modifiche.

Riepilogo delle modifiche

• È stato introdotto un nuovo modello per gli abbonamenti, incluse nuove entità che consentono di creare più offerte per un singolo prodotto in abbonamento. Per ulteriori informazioni, consulta la guida alla migrazione.
• Aggiunta di BillingClient.queryProductDetailsAsync() per sostituire BillingClient.querySkuDetailsAsync().
• Aggiunto il metodo setIsOfferPersonalized() per i requisiti di divulgazione relativi ai prezzi personalizzati nell'UE. Per scoprire di più su come utilizzare questo metodo, consulta Indicare un prezzo personalizzato.
• È stato rimosso queryPurchases(), precedentemente deprecato e sostituito da queryPurchasesAsync introdotto nella Libreria Fatturazione Google Play 4.0.0.
• launchPriceChangeFlow è stato deprecato e verrà rimosso in una futura release. Per scoprire di più sulle alternative, consulta Avviare un flusso di conferma della modifica del prezzo.
• Rimosso setVrPurchaseFlow(), che veniva utilizzato in precedenza durante l'istanza di un flusso di acquisto. Nelle versioni precedenti, questo metodo reindirizzava l'utente per completare l'acquisto sul suo dispositivo Android. Una volta rimosso questo metodo, gli utenti completeranno l'acquisto tramite il flusso di acquisto standard.

Rilascio della libreria Fatturazione Google Play 4.1 (23/02/2022)

Sono ora disponibili la versione 4.1.0 della Libreria Fatturazione Google Play e le estensioni Kotlin.

Questa versione contiene le seguenti modifiche.

Riepilogo delle modifiche

• È stato aggiunto BillingClient.showInAppMessages() per facilitare la gestione dei pagamenti degli abbonamenti rifiutati. Per scoprire di più su come utilizzare la messaggistica in-app per gestire i rifiuti dei pagamenti degli abbonamenti, consulta la sezione Gestire i rifiuti dei pagamenti.

Rilascio della libreria Fatturazione Google Play 4.0 (18/05/2021)

Sono ora disponibili la versione 4.0.0 della Libreria Fatturazione Google Play e le estensioni Kotlin.

Riepilogo delle modifiche

• È stato aggiunto BillingClient.queryPurchasesAsync() in sostituzione di BillingClient.queryPurchases() che verrà rimosso in una release futura.

• È stata aggiunta una nuova modalità di sostituzione dell'abbonamento IMMEDIATE_AND_CHARGE_FULL_PRICE.

• Aggiunto il metodo BillingClient.getConnectionState() per recuperare lo stato della connessione di Libreria Fatturazione Play.

• Javadoc e implementazione aggiornati per indicare il thread su cui è possibile chiamare un metodo e il thread in cui vengono pubblicati i risultati.

• È stato aggiunto BillingFlowParams.Builder.setSubscriptionUpdateParams() come nuovo modo per avviare gli aggiornamenti degli abbonamenti. Questo sostituisce BillingFlowParams#getReplaceSkusProrationMode, BillingFlowParams#getOldSkuPurchaseToken, BillingFlowParams#getOldSku, BillingFlowParams.Builder#setReplaceSkusProrationMode, BillingFlowParams.Builder#setOldSku che sono stati rimossi.

• Aggiunta di Purchase.getQuantity() e PurchaseHistoryRecord.getQuantity().

• Aggiunta di Purchase#getSkus() e PurchaseHistoryRecord#getSkus(). Questi sostituiscono Purchase#getSku e PurchaseHistoryRecord#getSku, che sono stati rimossi.

• BillingFlowParams#getSku, BillingFlowParams#getSkuDetails e BillingFlowParams#getSkuType rimossi.

Rilascio della libreria Fatturazione Google Play 3.0.3 (12/03/2021)

Sono ora disponibili la versione 3.0.3 della Libreria Fatturazione Google Play, l'estensione Kotlin e il plug-in Unity.

Correzioni di bug per Java e Kotlin

• È stata corretta la perdita di memoria quando viene chiamato endConnection().
• Risolvi il problema quando la Libreria Fatturazione Google Play viene utilizzata da app che utilizzano la modalità di avvio di una singola attività. Verrà attivato un onPurchasesUpdated() callback quando un'app viene ripristinata dal launcher Android e la finestra di dialogo di fatturazione era visibile prima della sospensione.

Correzioni di bug di Unity

• Esegui l'aggiornamento alla versione 3.0.3 di Java per correggere la perdita di memoria e risolvere il problema che impedisce gli acquisti quando un'app viene ripresa dal launcher Android e la finestra di dialogo di fatturazione era visibile prima della sospensione.

Rilascio della libreria Fatturazione Google Play 3.0.2 (24/11/2020)

Sono ora disponibili la versione 3.0.2 della Libreria Fatturazione Google Play e l'estensione Kotlin.

Correzioni di bug

• È stato corretto un bug nell'estensione Kotlin in cui la coroutine non va a buon fine con l'errore "Already resumed".
• Sono stati corretti i riferimenti non risolti quando l'estensione Kotlin viene utilizzata con la libreria kotlinx.coroutines versione 1.4 o successive.

Rilascio della libreria Fatturazione Google Play 3.0.1 (30/09/2020)

Le versioni 3.0.1 della Libreria Fatturazione Google Play e dell'estensione Kotlin sono ora disponibili.

Correzioni di bug

• È stato corretto un bug per cui, se l'app veniva chiusa e ripristinata durante il flusso di fatturazione, PurchasesUpdatedListener potrebbe non essere chiamato con il risultato dell'acquisto.

Rilascio della Libreria Fatturazione Google Play 3.0 (08/06/2020)

Sono ora disponibili la versione 3.0.0 della Libreria Fatturazione Google Play, l'estensione Kotlin e il plug-in Unity.

Riepilogo delle modifiche

• È stato rimosso il supporto degli SKU con premio.
• Sono stati rimossi i parametri ChildDirected e UnderAgeOfConsent.
• Sono stati rimossi i metodi di payload per sviluppatori deprecati.
• Sono stati rimossi i metodi deprecati BillingFlowParams.setAccountId() e BillingFlowParams.setDeveloperId().
• Sono stati rimossi i metodi deprecati BillingFlowParams.setOldSkus(String oldSku) e BillingFlowParams.addOldSku(String oldSku).
• Sono state aggiunte annotazioni di nullabilità.

Correzioni di bug

• SkuDetails.getIntroductoryPriceCycles() ora restituisce int anziché String.
• È stato corretto un bug per cui il flusso di fatturazione veniva trattato come se avesse parametri aggiuntivi anche se non erano stati impostati.

Release della libreria Fatturazione Google Play 2.2.1 (20/05/2020)

La versione 2.2.1 della libreria Google Play Billing è ora disponibile.

Correzioni di bug

• È stata aggiornata la versione predefinita della libreria Java Play Billing da cui dipende l'estensione Kotlin.

Rilascio della libreria Google Play Billing 2.2.0 e supporto di Unity (23/03/2020)

La versione 2.2.0 di Google Play Billing fornisce funzionalità che aiutano gli sviluppatori a garantire che gli acquisti siano attribuiti all'utente corretto. Queste modifiche sostituiscono la necessità di creare soluzioni personalizzate basate sul payload dello sviluppatore. Nell'ambito di questo aggiornamento, la funzionalità del payload dello sviluppatore è stata ritirata e verrà rimossa in una versione futura. Per ulteriori informazioni, incluse le alternative consigliate, consulta Payload sviluppatore.

Libreria Fatturazione Google Play 2 per Unity

Oltre alle attuali versioni Java e Kotlin di Libreria Fatturazione Google Play 2, abbiamo rilasciato una versione della libreria da utilizzare con Unity. Gli sviluppatori di giochi che utilizzano l'API per gli acquisti in-app di Unity possono eseguire l'upgrade ora per usufruire di tutte le funzionalità della Libreria Fatturazione Google Play 2 e per semplificare gli upgrade successivi alle versioni future della libreria.

Per saperne di più, consulta Utilizzare Fatturazione Google Play con Unity.

Riepilogo delle modifiche

• Libreria Fatturazione Google Play Java
  • In AcknowledgePurchaseParams, deprecati setDeveloperPayload() e getDeveloperPayload() metodi.
  • In ConsumeParams, deprecati setDeveloperPayload() e getDeveloperPayload() metodi.
  • In BillingFlowParams, è stato rinominato setAccountId() in setObfuscatedAccountId(), ed è stata documentata la limitazione della lunghezza a 64 caratteri e la limitazione che non consente l'inserimento di informazioni che consentono l'identificazione personale (PII) in questo campo. setAccountId() è stato contrassegnato come obsoleto e verrà rimosso in una futura versione della libreria.
  • In BillingFlowParams, è stato aggiunto setObfuscatedProfileId() che funziona in modo simile a setObfuscatedAccountId(). Per saperne di più, consulta Aggiornamenti e alternative del payload dello sviluppatore.
  • In Purchase, è stato aggiunto il metodo getAccountIdentifiers() per restituire gli identificatori dell'account offuscati impostati in BillingFlowParams.
  • In BillingClient, il metodo loadRewardedSku() è stato contrassegnato come deprecato nell'ambito del ritiro degli SKU con premio. Puoi trovare maggiori informazioni sul ritiro nel Centro assistenza Play Console.

Rilascio della Libreria Fatturazione Google Play 2.1.0 e dell'estensione Kotlin 2.1.0 (10/12/2019)

Sono ora disponibili la versione 2.1.0 della libreria Fatturazione Google Play e la nuova estensione Kotlin. L'estensione Kotlin della libreria Play Billing Library fornisce alternative idiomatiche alle API per l'utilizzo di Kotlin, con una migliore sicurezza null e coroutine. Per esempi di codice, vedi Utilizzare la Libreria Fatturazione Google Play.

Questa versione contiene le seguenti modifiche.

Riepilogo delle modifiche

• In BillingFlowParams, setOldSku(String oldSku) è stato ritirato e sostituito con setOldSku(String oldSku, String purchaseToken), per distinguere quando più account sul dispositivo possiedono lo stesso SKU.

Rilascio della libreria Fatturazione Google Play 2.0.3 (05/08/2019)

La versione 2.0.3 della libreria Fatturazione Google Play è ora disponibile.

Correzioni di bug

• È stato corretto un bug per cui querySkuDetailsAsync() a volte non riusciva a restituire il codice DEVELOPER_ERROR anziché un risultato positivo.

Release della libreria Fatturazione Google Play 2.0.2 (08/07/2019)

La versione 2.0.2 della libreria Google Play Billing è ora disponibile. Questa release contiene aggiornamenti alla documentazione di riferimento e non modifica la funzionalità della libreria.

Rilascio della libreria Fatturazione Google Play 2.0.1 (06/06/2019)

La versione 2.0.1 della libreria Fatturazione Google Play è ora disponibile. Questa versione contiene le seguenti modifiche.

Correzioni di bug

• È stato corretto un bug per cui in alcuni casi i messaggi di debug venivano restituiti come null.
• È stato risolto un potenziale problema di perdita di memoria.

Rilascio della libreria Fatturazione Google Play 2.0 (7/05/2019)

È ora disponibile la versione 2.0 della libreria Fatturazione Google Play. Questa versione contiene le seguenti modifiche.

Gli acquisti devono essere confermati entro tre giorni

Google Play supporta l'acquisto di prodotti dall'interno dell'app (in-app) o dall'esterno dell'app (out-of-app). Affinché Google Play possa garantire un'esperienza di acquisto coerente indipendentemente da dove l'utente acquista il tuo prodotto, devi confermare tutti gli acquisti ricevuti tramite la Libreria Fatturazione Google Play il prima possibile dopo aver concesso il diritto all'utente. Se non confermi un acquisto entro tre giorni, l'utente riceve automaticamente un rimborso e Google Play revoca l'acquisto. Per le transazioni in attesa (novità della versione 2.0), il periodo di tre giorni inizia quando l'acquisto è passato allo stato PURCHASED e non si applica mentre l'acquisto è nello stato PENDING.

Per gli abbonamenti, devi confermare qualsiasi acquisto che abbia un nuovo token di acquisto. Ciò significa che tutti gli acquisti iniziali, le modifiche al piano e le nuove registrazioni devono essere confermati, ma non è necessario confermare i rinnovi successivi. Per determinare se un acquisto richiede una conferma, puoi controllare il campo di conferma nell'acquisto.

L'oggetto Purchase ora include un metodo isAcknowledged() che indica se un acquisto è stato riconosciuto. Inoltre, l'API Google Play Developer include valori booleani di conferma sia per Purchases.products che per Purchases.subscriptions. Prima di confermare un acquisto, assicurati di utilizzare questi metodi per determinare se l'acquisto è già stato confermato.

Puoi confermare un acquisto utilizzando uno dei seguenti metodi:

• Per i prodotti di consumo, utilizza consumeAsync(), che si trova nell'API client.
• Per i prodotti non consumati, utilizza acknowledgePurchase(), disponibile nell'API client.
• Nell'API Server è disponibile anche un nuovo metodo acknowledge().

BillingFlowParams.setSku() è stato rimosso

Il metodo BillingFlowParams#setSku() precedentemente ritirato è stato rimosso in questa release. Prima di eseguire il rendering dei prodotti in un flusso di acquisto, ora devi chiamare BillingClient.querySkuDetailsAsync(), passando l'oggetto SkuDetails risultante a BillingFlowParams.Builder.setSkuDetails().

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

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

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

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

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()
}

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();
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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