Note di rilascio dell'API Google Play Developer

Questo documento contiene le note di rilascio delle API Google Play Developer.

6 luglio 2026

Nuove funzionalità

• Aggiornamenti relativi alla responsabilità per i costi di storno di addebito: Google Play ora supporta una procedura di contestazione dello storno di addebito collaborativa.

  • Notifiche di revisione del rimborso in attesa: viene inviato un nuovo tipo di notifica in tempo reale per lo sviluppatore (RTDN), PendingRefundReviewNotification, quando un utente richiede uno storno di addebito che richiede la tua revisione. Le revisioni in attesa supportano solo CHARGEBACK come motivo del rimborso.

  • API ReviewRefund: puoi valutare queste richieste e rispondere entro 24 ore chiamando la nuova API orders.reviewrefund. Nella chiamata API, devi fornire una preferenza di rimborso (ad esempio APPROVE, DECLINE o NEUTRAL) ed eventuali prove di utilizzo dell'acquisto pertinenti (ad esempio indirizzo IP dell'utente, percentuale di consumo cumulativa e posizione geografica approssimativa) per aiutare Google Play a contestare lo storno di addebito.

19 maggio 2026

Nuove funzionalità

• ID ordine in attesa: l'API SubscriptionPurchaseV2 ora include onHoldStateContext e inGracePeriodStateContext campi. Questi campi forniscono dettagli aggiuntivi, come l'ID ordine in attesa o non riuscito, quando un abbonamento entra nello stato ON_HOLD o IN_GRACE_PERIOD a causa di un pagamento di rinnovo rifiutato.

Ritiri

• Alcune API per gli abbonamenti sono ritirate. Per maggiori informazioni, consulta Ritiro delle API per gli abbonamenti a maggio 2026.

27 gennaio 2026

Nuove funzionalità

• Rinvio dell'abbonamento con componenti aggiuntivi: in precedenza, l'API Google Play Developer consentiva di rinviare la fatturazione solo per i singoli abbonamenti. La funzionalità di rinvio è ora disponibile sia per i singoli abbonamenti sia per gli abbonamenti con componenti aggiuntivi tramite il purchases.subscriptionsv2.defer metodo. Quando rinvii la data di fatturazione di un abbonamento con componenti aggiuntivi, la data di fatturazione di tutti gli articoli dell'abbonamento viene rinviata per la durata specificata.

• OfferPhase: il campo OfferPhase è ora disponibile nell' API SubscriptionPurchaseV2. Questo campo fornisce la fase dell'offerta corrente dell'abbonamento come periodo proporzionale, prova senza costi, prezzo di lancio e prezzo del piano base.

19 novembre 2025

Nuove funzionalità

• Gestione migliorata della riattivazione dell'abbonamento.

  • Il campo outOfAppPurchaseContext è ora disponibile in SubscriptionPurchaseV2 e consente di collegare gli acquisti di riattivazione dell'abbonamento effettuati dal Play Store fornendo i dettagli dell'abbonamento scaduto.
  • Il metodo purchases.subscriptions.acknowledge ora accetta facoltativo externalAccountId nel corpo della richiesta, che ti consente di associare l'acquisto di riattivazione dell'abbonamento ai tuoi identificatori utente.

• Il campo SubscriptionPurchaseLineItem.itemReplacement è ora disponibile in SubscriptionPurchaseV2 e fornisce dettagli sull'articolo sostituito, se applicabile.

• L'API Orders ora include il campo offerPhaseDetails, che fornisce informazioni più dettagliate sui finanziamenti degli ordini per un periodo proporzionale.

11 settembre 2025

Nuove funzionalità

• L'API SubscriptionPurchaseV2 ora fornisce il metodo cancel.

  Questo metodo offre un miglioramento rispetto alla funzionalità esistente purchases.subscriptions.cancel introducendo il supporto per il parametro cancellationType nelle librerie client.

• Sono disponibili le funzionalità di consenso all'aumento graduale del prezzo :

  • È stato aggiunto un nuovo campo in SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • È disponibile un nuovo tipo di notifica in tempo reale per lo sviluppatore SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.

30 giugno 2025

Nuove funzionalità

• È disponibile la nuova API ProductPurchaseV2 che supporta più opzioni di acquisto e offerte per i prodotti a pagamento singolo.

21 maggio 2025

Ritiri

• Alcune API per gli abbonamenti sono ritirate. Per maggiori informazioni, consulta Ritiro delle API per gli abbonamenti.

Nuove funzionalità

• I seguenti nuovi campi sono disponibili in SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• Il subscriptionsv2.revoke metodo ora fornisce l' item_based_refund opzione.

• L'API Orders ora fornisce i metodi get e batchGet.

Altre modifiche

• Il parametro subscriptionId è facoltativo nelle API purchases.subscriptions.