Ritiri

Questo documento elenca le API Google Play Developer e le funzionalità correlate in fase di ritiro.

Tempistiche di ritiro: dal 21 maggio 2025 al 31 agosto 2027

Le funzionalità e le API in questa sezione sono deprecate 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 di abbonamento deprecate

Questa sezione elenca il ritiro delle API.

API Sostituzione disponibile
subscriptions.get subscriptionsv2.get
subscriptions.refund Chiama subscriptionsv2.get per ottenere SubscriptionPurchaseLineItem. latest_successful_order_id, quindi 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 dell'abbonamento precedente vengono mappati ai campi corrispondenti in purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(nessun campo equivalente) lineItems (elenco di SubscriptionPurchaseLineItem) che rappresenta i prodotti acquistati 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 effettuati da tester con licenza)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (nessun campo equivalente)
Queste informazioni sono disponibili in offer per ciascuno degli abbonamenti acquistati.
developerPayload (Nessun campo equivalente) Il payload sviluppatore è 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:
    • Campo Order.line_items.subscription_details.offer_phase che puoi recuperare tramite l'API Orders.get.
  • Upgrade / downgrade differito:
    • 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 è stato eseguito l'upgrade di purchases.subscriptions:get a purchases.subscriptionsv2:get, per il momento il resto delle funzioni di gestione degli abbonamenti degli sviluppatori rimane immutato nell'endpoint purchases.subscriptions, pertanto puoi continuare a utilizzare purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund, e purchases.subscriptions:revoke come prima.