Descontinuações

Este documento lista as APIs Google Play Developer e os recursos relacionados que estão em período de descontinuação.

Cronograma de descontinuação: de 19 de maio de 2026 a 31 de agosto de 2028

Os recursos e as APIs nesta seção serão descontinuados em 19 de maio de 2026 e desativados em 31 de agosto de 2028. No entanto, você pode aproveitar uma extensão para os itens descontinuados até 1º de novembro de 2028.

APIs de assinatura descontinuadas

Esta seção lista as descontinuações de APIs.

API Substituição disponível
subscriptions.cancel subscriptionsv2.cancel
subscriptions.defer subscriptionsv2.defer
Order.lineItems.subscriptionDetails.offer_phase Order.lineItems.subscriptionDetails.offer_phase_details

Cronograma de descontinuação: de 21 de maio de 2025 a 31 de agosto de 2027

Os recursos e as APIs nesta seção serão descontinuados em 21 de maio de 2025 e desativados em 31 de agosto de 2027. No entanto, você pode aproveitar uma extensão para os itens descontinuados até 1º de novembro de 2027.

APIs de assinatura descontinuadas

Esta seção lista as descontinuações de APIs.

API Substituição disponível
subscriptions.get subscriptionsv2.get
subscriptions.refund Chame subscriptionsv2.get para receber SubscriptionPurchaseLineItem. latest_successful_order_id, e, em seguida, chame Orders.refund para reembolsar os pedidos.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Nenhuma substituição
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Campos SubscriptionPurchaseV2 para assinaturas recorrentes

purchases.subscriptionv2 contém novos campos que apresentam mais detalhes sobre novos objetos de assinatura. A tabela a seguir mostra a maneira como os campos do endpoint de assinatura legado equivalem aos campos correspondentes em purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId lineItems.latestSuccessfulOrderId
Você pode receber o ID do pedido pendente de inGracePeriodStateContext.renewalDeclined.pendingOrderId ou onHoldStateContext.renewalDeclined.pendingOrderId.
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (cada assinatura adquirida na compra tem um expiryTime próprio)
autoResumeTimeMillis pausedStateContext.autoResumeTime
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo lineItems.offerPhase.introductoryPrice
Essas informações também podem ser encontradas no offer para cada uma das assinaturas compradas.
developerPayload (nenhum campo equivalente) o payload do desenvolvedor foi descontinuado
paymentState (nenhum campo equivalente)
É possível inferir o estado do pagamento de subscriptionState:
  • O pagamento está pendente:
    • SUBSCRIPTION_STATE_PENDING (novas compras com transação pendente)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • O pagamento foi recebido:
    • SUBSCRIPTION_STATE_ACTIVE
  • Teste sem custo financeiro:
    • lineItems.offerPhase.freeTrial
  • Upgrade / downgrade interrompido:
    • lineItems.deferredItemReplacement
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (nenhuma mudança)
purchaseType Teste: com testPurchase
Promoção: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers