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 19 maggio 2026 al 31 agosto 2028

Le funzionalità e le API in questa sezione sono ritirate a partire dal 19 maggio 2026 e verranno ritirate il 31 agosto 2028. Tuttavia, puoi richiedere un'estensione per gli elementi ritirati fino al 1° novembre 2028.

API per gli abbonamenti ritirate

In questa sezione sono elencati i ritiri delle API.

API Sostituzione disponibile
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

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

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

API per gli abbonamenti ritirate

In questa sezione sono elencati i ritiri 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 di abbonamento legacy vengono mappati ai campi corrispondenti in purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
Puoi ottenere l'ID ordine in attesa da inGracePeriodStateContext.renewalDeclined.pendingOrderId o onHoldStateContext.renewalDeclined.pendingOrderId.
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (ogni abbonamento acquisito nell'acquisto ha il proprio expiryTime)
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
Queste informazioni sono disponibili anche nel offer per ciascuno degli abbonamenti acquistati.
developerPayload (nessun campo equivalente) il payload dello sviluppatore è stato ritirato
paymentState (nessun campo equivalente)
Puoi dedurre lo stato del pagamento da subscriptionState:
  • Pagamento in attesa:
    • SUBSCRIPTION_STATE_PENDING (nuovi acquisti con transazione in attesa)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Pagamento ricevuto:
    • SUBSCRIPTION_STATE_ACTIVE
  • Prova senza costi:
    • lineItems.offerPhase.freeTrial
  • Upgrade / downgrade posticipato:
    • lineItems.deferredItemReplacement
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (nessuna modifica)
purchaseType Test: tramite testPurchase
Promozione: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers