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: de 21 de maio de 2025 a 31 de agosto de 2027

Os recursos e as APIs desta seção foram descontinuados em 21 de maio de 2025 e serão encerrados em 31 de agosto de 2027. No entanto, você pode usar 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 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 SubscriptionPurchaseLineItem.latest_successful_order_id
(nenhum campo equivalente) lineItems (lista de SubscriptionPurchaseLineItem) que representa os produtos adquiridos com a compra
(nenhum campo equivalente) lineItems.offerDetails.basePlanId
(nenhum campo equivalente) lineItems.offerDetails.offerId
(nenhum campo equivalente) lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (cada assinatura adquirida na compra tem um expiryTime próprio)
(nenhum campo equivalente) subscriptionState (indica o estado da assinatura)
(nenhum campo equivalente) pausedStateContext (presente apenas se o status da assinatura for SUBSCRIPTION_STATE_PAUSED)
autoResumeTimeMillis pausedStateContext.autoResumeTime
(nenhum campo equivalente) canceledStateContext (presente apenas se o status da assinatura for SUBSCRIPTION_STATE_CANCELED)
(nenhum campo equivalente) testPurchase (presente somente em compras de testadores licenciados)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (nenhum campo equivalente)
Essas informações 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:
    • O campo order.line_items.subscription_details.offer_phase, que pode ser buscado pela API Orders.get.
  • Upgrade/downgrade interrompido:
    • SUBSCRIPTION_STATE_PENDING
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

Outras funções de gerenciamento de assinaturas

Embora purchases.subscriptions:get tenha sido atualizada para purchases.subscriptionsv2:get, as outras funções de gerenciamento de assinaturas do desenvolvedor continuam inalteradas no endpoint purchases.subscriptions por enquanto, para que você possa continuar a usar purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund e purchases.subscriptions:revoke como antes.