Ritiri

Questo documento elenca le API Google Play Developer e le funzionalità correlate che si trovano in un periodo di ritiro.

Cronologia del ritiro: dal 21 maggio 2025 al 31 agosto 2027

Le funzionalità e le API in questa sezione sono deprecate a partire dal 21 maggio 2025 e verranno disattivate il 31 agosto 2027. Tuttavia, puoi usufruire di un'estensione per gli elementi ritirati fino al 1° novembre 2027.

API per gli abbonamenti deprecate

Questa sezione elenca le API ritirate.

API	Sostituzione disponibile
subscriptions.get	subscriptionsv2.get
subscriptions.refund	Chiama subscriptionsv2.get per ottenere SubscriptionPurchaseLineItem. latest_successful_order_id, e poi chiama Orders.refund per rimborsare gli ordini.
subscriptions.revoke	subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId	SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId	Nessuna sostituzione
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED	SUBSCRIPTION_PRICE _CHANGE_UPDATED

Campi SubscriptionPurchaseV2 per gli abbonamenti ricorrenti

purchases.subscriptionv2 contiene nuovi campi che forniscono maggiori dettagli sui nuovi oggetti di abbonamento. La tabella seguente mostra come i campi dell'endpoint di abbonamento legacy vengono mappati ai campi corrispondenti in purchases.subscriptionv2.

SubscriptionPurchase	SubscriptionPurchaseV2
`countryCode`	`regionCode`
`orderId`	`SubscriptionPurchaseLineItem.latest_successful_order_id`
(nessun campo equivalente)	`lineItems.offerPhase` (identifica la fase attuale: prova senza costi, prezzo di lancio, ripartizione proporzionale, prezzo base)
(nessun campo equivalente)	`lineItems` (elenco di SubscriptionPurchaseLineItem) che rappresenta i prodotti acquisiti con l'acquisto
(nessun campo equivalente)	`lineItems.offerDetails.basePlanId`
(nessun campo equivalente)	`lineItems.offerDetails.offerId`
(nessun campo equivalente)	`lineItems.offerDetails.offerTags`
`startTimeMillis`	`startTime`
`expiryTimeMillis`	`lineItems.expiryTime` (ogni abbonamento acquisito nell'acquisto ha il proprio `expiryTime`)
(nessun campo equivalente)	`subscriptionState` (indica lo stato dell'abbonamento)
(nessun campo equivalente)	`pausedStateContext` (presente solo se lo stato dell'abbonamento è `SUBSCRIPTION_STATE_PAUSED`)
`autoResumeTimeMillis`	`pausedStateContext.autoResumeTime`
(nessun campo equivalente)	`canceledStateContext` (presente solo se lo stato dell'abbonamento è `SUBSCRIPTION_STATE_CANCELED`)
(nessun campo equivalente)	`testPurchase` (presente solo negli acquisti dei tester con licenza)
`autoRenewing`	`lineItems.autoRenewingPlan.autoRenewEnabled`
`priceCurrenceCode`, `priceAmountMicros`	`lineItems.autoRenewingPlan.recurringPrice`
`introductoryPriceInfo`	`lineItems.offerPhase.introductoryPrice` Queste informazioni sono disponibili anche nella `offer` per ciascuno degli abbonamenti acquistati.
developerPayload	Il payload dello sviluppatore (nessun campo equivalente) è stato ritirato
paymentState	(nessun campo equivalente) Puoi dedurre lo stato del pagamento da `subscriptionState`: Il pagamento è in attesa: `SUBSCRIPTION_STATE_PENDING` (nuovi acquisti con transazione in attesa) `SUBSCRIPTION_STATE_IN_GRACE_PERIOD` `SUBSCRIPTION_STATE_ON_HOLD` Il pagamento è stato ricevuto: `SUBSCRIPTION_STATE_ACTIVE` Prova senza costi: lineItems.offerPhase.freeTrial Upgrade / downgrade posticipato: `SUBSCRIPTION_STATE_PENDING`
`cancelReason`, `userCancellationTimeMillis`, `cancelSurveyResult`	`canceledStateContext`
`linkedPurchaseToken`	`linkedPurchaseToken` (nessuna modifica)
`purchaseType`	Test: fino al giorno `testPurchase` Promozione: `signupPromotion`
`priceChange`	`lineItems.autoRenewingPlan.priceChangeDetails`
`profileName`, `emailAddress`, `givenName`, `familyName`, `profileId`	`subscribeWithGoogleInfo`
`acknowledgementState`	`acknowledgementState (no change)`
`promotionType`, `promotionCode`	`signupPromotion`
`externalAccountId`, `obfuscatedExternalAccountId`, `obfuscatedExteranlProfileId`	`externalAccountIdentifiers`

Altre funzioni di gestione degli abbonamenti

Anche se purchases.subscriptions:get è stato aggiornato a purchases.subscriptionsv2:get, per il momento le altre funzioni di gestione degli abbonamenti per sviluppatori rimangono invariate nell'endpoint purchases.subscriptions, quindi puoi continuare a utilizzare purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund, e purchases.subscriptions:revoke come facevi prima.