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 nesta seção foram descontinuados em 21 de maio de 2025 e serão desativados em 31 de agosto de 2027. No entanto, é possível 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 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	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`	`SubscriptionPurchaseLineItem.latest_successful_order_id`
(nenhum campo equivalente)	`lineItems.offerPhase` (identifica a fase atual: teste sem custo financeiro, preço inicial, proporcionalidade, preço base)
(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`	`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: `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.