Note di rilascio dell'API Google Play Developer

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

6 luglio 2026

Nuove funzionalità

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

  • Notifiche di revisione dei rimborsi in attesa: un nuovo tipo di notifica in tempo reale per lo sviluppatore (RTDN), PendingRefundReviewNotification, viene inviato quando un utente richiede uno storno 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 cumulativo e posizione geografica approssimativa) per aiutare Google Play a contestare la riaddebito.

19 maggio 2026

Nuove funzionalità

• ID ordine in attesa: l'API SubscriptionPurchaseV2 ora include i campi onHoldStateContext e inGracePeriodStateContext. Questi campi forniscono ulteriori dettagli, 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 di abbonamento sono obsolete. Per saperne di più, consulta Ritiro dell'API Subscription di maggio 2026.

27 gennaio 2026

Nuove funzionalità

• Differimento dell'abbonamento con componenti aggiuntivi: in precedenza, l'API Google Play Developer consentiva il differimento della fatturazione solo per i singoli abbonamenti. La funzionalità di posticipo è ora disponibile sia per gli abbonamenti singoli sia per gli abbonamenti con componenti aggiuntivi tramite il metodo purchases.subscriptionsv2.defer. Quando posticipi la data di fatturazione di un abbonamento con componenti aggiuntivi, la data di fatturazione di tutti gli elementi dell'abbonamento viene posticipata 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 avanzata delle nuove iscrizioni.

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

• Il campo SubscriptionPurchaseLineItem.itemReplacement è ora disponibile in SubscriptionPurchaseV2, che offre dettagli sull'articolo da sostituire, se applicabile.

• L'API Orders ora include il campo offerPhaseDetails, che fornisce informazioni più dettagliate sugli ordini che finanziano un periodo proporzionale.

11 settembre 2025

Nuove funzionalità

• L'API SubscriptionPurchaseV2 ora fornisce il metodo cancel.

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

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

  • Un nuovo campo viene aggiunto 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 di abbonamento sono obsolete. Per saperne di più, consulta la sezione Ritiro dell'API Subscription.

Nuove funzionalità

• I seguenti nuovi campi sono disponibili in SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

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

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

Altre modifiche

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