Descontinuações

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

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

Os recursos e as APIs nesta seção foram descontinuados em 19 de maio de 2026 e serão desativados em 31 de agosto de 2028. Para itens descontinuados, você pode pedir uma extensão até 1º de novembro de 2028 enviando um tíquete de suporte em Play Console > Ajuda.

APIs de assinatura descontinuadas

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

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 foram descontinuados em 21 de maio de 2025 e serão desativados em 31 de agosto de 2027. Para itens descontinuados, você pode pedir uma extensão até 1º de novembro de 2027 enviando um tíquete de suporte em Play Console > Ajuda.

APIs de assinatura descontinuadas

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

API Substituição disponível
subscriptions.get subscriptionsv2.get
subscriptions.refund Chame subscriptionsv2.get para receber SubscriptionPurchaseLineItem. latest_successful_order_id, e chame Orders.refund para reembolsar os pedidos.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Sem 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 conseguir o ID do pedido pendente em 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 de 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