Notas da versão da API Google Play Developer

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

27 de janeiro de 2026

Novos recursos

• Adiar assinatura com complementos:antes, a API Google Play Developer permitia o adiamento do faturamento apenas para assinaturas únicas. A funcionalidade de adiamento agora está disponível para assinaturas únicas e com complementos pelo método purchases.subscriptionsv2.defer. Ao adiar a data de faturamento de uma assinatura com complementos, a data de faturamento de todos os itens da assinatura é adiada pelo período especificado.

• OfferPhase: o campo OfferPhase agora está disponível na API SubscriptionPurchaseV2. Esse campo fornece a fase atual da oferta da assinatura como um dos períodos proporcionais, teste sem custo financeiro, preço inicial e preço do plano básico.

19 de novembro de 2025

Novos recursos

• Melhoria no processamento de novas assinaturas.

  • O campo outOfAppPurchaseContext agora está disponível em SubscriptionPurchaseV2, que ajuda a vincular compras de renovação de assinatura feitas na Play Store fornecendo detalhes da assinatura expirada.
  • O método purchases.subscriptions.acknowledge agora aceita externalAccountId opcional no corpo da solicitação, permitindo associar a compra de renovação da assinatura aos seus identificadores de 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.

• No momento, esses novos recursos estão disponíveis apenas pelas APIs e não pelas bibliotecas de cliente.

11 de setembro de 2025

Novos recursos

• A API SubscriptionPurchaseV2 agora oferece o método cancel.

  Esse método oferece uma melhoria em relação à funcionalidade purchases.subscriptions.cancel atual ao introduzir suporte para o parâmetro cancellationType nas bibliotecas de cliente.

• Os recursos de consentimento de aumento gradual de preço estão disponíveis:

  • Um novo campo foi adicionado ao 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.

30 de junho de 2025

Novos recursos

• A nova API ProductPurchaseV2, que oferece suporte a várias opções de compra e ofertas para produtos únicos, já está disponível.

21 de maio de 2025

Suspensões de uso

• Algumas APIs de assinatura estão obsoletas. Para mais informações, consulte Descontinuação da API Subscription.

Novos recursos

• Os seguintes campos novos estão disponíveis em 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.

Outras mudanças

• O parâmetro subscriptionId é opcional nas APIs purchases.subscriptions.