Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Notas da versão da API Google Play Developer

Este documento contém notas da versão das APIs Google Play Developer.

19 de maio de 2026

ID do pedido pendente: a API SubscriptionPurchaseV2 agora inclui os campos onHoldStateContext e inGracePeriodStateContext. Esses campos fornecem mais detalhes, como o ID do pedido pendente ou com falha, quando uma assinatura entra no estado ON_HOLD ou IN_GRACE_PERIOD devido a um pagamento de renovação recusado.

Algumas das APIs de assinatura foram suspensas. Para mais informações, consulte Suspensão de uso da API Subscription de maio de 2026.

Adiar assinatura com complementos: antes, a API Google Play Developer permitia o adiamento do faturamento apenas para assinaturas únicas. Agora, a funcionalidade de adiamento está disponível para assinaturas únicas e com complementos usando o purchases.subscriptionsv2.defer método. Ao adiar a data de faturamento de uma assinatura com complementos, a data de faturamento de todos os itens da assinatura é adiada pela duração especificada.
OfferPhase: o campo OfferPhase agora está disponível na API SubscriptionPurchaseV2. Esse campo fornece a fase atual da assinatura como um período proporcional, teste sem custo financeiro, preço inicial e preço do plano básico.

Processamento de nova assinatura aprimorado.
- O campo outOfAppPurchaseContext agora está disponível em SubscriptionPurchaseV2, o que ajuda a vincular compras de novas assinaturas feitas na Google Play Store, fornecendo detalhes da assinatura expirada.
- O método purchases.subscriptions.acknowledge agora aceita opcional externalAccountId no corpo da solicitação, o que permite associar a compra de nova assinatura aos identificadores do usuário.
O campo SubscriptionPurchaseLineItem.itemReplacement agora está disponível em SubscriptionPurchaseV2, que oferece detalhes sobre o item que está sendo substituído, se aplicável.
A API Orders agora inclui o campo offerPhaseDetails, que fornece informações mais detalhadas sobre os pedidos que financiam um período proporcional.

A API SubscriptionPurchaseV2 agora fornece o método cancel.

Esse método oferece um aprimoramento da funcionalidade existente purchases.subscriptions.cancel, introduzindo suporte para o cancellationType parâmetro nas bibliotecas de cliente.
Os recursos de consentimento de aumento de preço estão disponíveis:
- Um novo campo foi adicionado à SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.
- Um novo tipo de notificação do desenvolvedor em tempo real SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED está disponível.

Algumas das APIs de assinatura foram suspensas. Para mais informações, consulte Suspensão de uso da API Subscription.

Os novos campos a seguir estão disponíveis na SubscriptionPurchaseV2:
- SubscriptionPurchaseLineItem.latest_successful_order_id
- PriceChangeState.CANCELED
O método subscriptionsv2.revoke agora oferece a opção item_based_refund.
A API Orders agora oferece os métodos get e batchGet.