Este documento contém notas da versão das APIs Google Play Developer.
19 de novembro de 2026
Novos recursos
Ofertas de retenção: agora é possível criar ofertas de retenção que o Google Play mostra aos assinantes qualificados quando eles tentam cancelar.
- Segmentação de retenção: para criar ou atualizar uma oferta de retenção com
o método
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchoumonetization.subscriptions.basePlans.offers.batchUpdate, definaretentionRuleno campotargetingda oferta como um objetoRetentionTargetingRule. Use os camposscope,minDuration,allowMultipleClaimseminOfferCooldownDurationpara definir quais assinantes estão qualificados e se eles podem resgatar a oferta mais de uma vez. - Período de disponibilidade da oferta: o recurso
SubscriptionOfferagora inclui os campos opcionaisstartTimeeendTime, que definem quando uma oferta, como uma oferta de retenção, fica disponível e quando deixa de estar disponível. - Segmentação por usuário: para disponibilizar uma oferta de retenção apenas para
assinantes específicos, defina
retentionPerUserRule(RetentionPerUserTargetingRule) no campotargetingda oferta. Para segmentar a oferta para uma assinatura, chame o métodopurchases.subscriptionsv2.activateOfferTargetingcompurchaseTokeneofferId. Para remover a segmentação, chame o métodopurchases.subscriptionsv2.deactivateOfferTargeting. O recurso SubscriptionPurchaseV2 lista as ofertas segmentadas para cada item de linha no campodeveloperTargetedOffers, incluindo oofferIde oactivateTimede cada oferta. - Notificações de transição de plano: um novo tipo de RTDN de assinatura,
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21), é enviado quando um assinante aceita uma oferta de retenção. - Detalhes da transição do plano: o recurso SubscriptionPurchaseV2
agora inclui um objeto
planTransitionDetailsemautoRenewingPlan. Ele identifica a oferta de retenção aceita emofferIde informa o estado de transição emtransitionInfo.
- Segmentação de retenção: para criar ou atualizar uma oferta de retenção com
o método
Validação de ETag para cancelamento e revogação de assinaturas: os métodos
purchases.subscriptionsv2.cancelepurchases.subscriptionsv2.revokeagora são compatíveis com um campo opcionaletagemCancellationContexteRevocationContext. Use o campoetagpara evitar conflitos quando várias solicitações modificarem a mesma assinatura ao mesmo tempo. Receba o valor deetagdo campoetagde nível superior retornado pela chamadapurchases.subscriptionsv2.getmais recente.
6 de julho de 2026
Novos recursos
Atualizações na responsabilidade pelos custos de estorno: o Google Play agora oferece um processo de disputa de estorno colaborativo.
Notificações de análise de reembolso pendente: um novo tipo de notificação do desenvolvedor em tempo real (RTDN, na sigla em inglês),
PendingRefundReviewNotification, é enviado quando um usuário solicita um estorno que exige sua análise. As revisões pendentes aceitam apenasCHARGEBACKcomo motivo do reembolso.API ReviewRefund: é possível avaliar essas solicitações e responder em até 24 horas chamando a nova API
orders.reviewrefund. Na chamada de API, é necessário fornecer uma preferência de reembolso (comoAPPROVE,DECLINEouNEUTRAL) e qualquer evidência relevante de uso da compra (como endereço IP do usuário, porcentagem de consumo cumulativo e localização geográfica aproximada) para ajudar o Google Play a contestar o estorno.
19 de maio de 2026
Novos recursos
- código do pedido pendente: a API SubscriptionPurchaseV2 agora inclui os campos
onHoldStateContexteinGracePeriodStateContext. Esses campos fornecem mais detalhes, como o código do pedido pendente ou com falha, quando uma assinatura entra no estadoON_HOLDouIN_GRACE_PERIODdevido a um pagamento de renovação recusado.
Suspensões de uso
- Algumas das APIs de assinatura foram descontinuadas. Para mais informações, consulte Descontinuação da API Subscription em maio de 2026.
27 de janeiro de 2026
Novos recursos
Adiantamento de assinatura com complementos: antes, a API Google Play Developer permitia o adiantamento de faturamento apenas para assinaturas únicas. A funcionalidade de adiamento agora está disponível para assinaturas únicas e assinaturas com complementos usando o método
purchases.subscriptionsv2.defer. Quando você adia a data de faturamento de uma assinatura com complementos, a data de faturamento de todos os itens na assinatura é adiada pela duração especificada.OfferPhase: o campo
OfferPhaseagora está disponível na API SubscriptionPurchaseV2. Esse campo fornece a fase atual da oferta da assinatura como um dos seguintes: período proporcional, teste sem custo financeiro, preço inicial e preço do plano básico.
19 de novembro de 2025
Novos recursos
Tratamento de renovação de assinatura aprimorado.
- O campo
outOfAppPurchaseContextagora está disponível em SubscriptionPurchaseV2, o 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
externalAccountIdopcional no corpo da solicitação, o que permite associar a compra de renovação de assinatura aos identificadores de usuário.
- O campo
O campo
SubscriptionPurchaseLineItem.itemReplacementagora 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.
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, introduzindo suporte para o parâmetro
cancellationTypenas bibliotecas de cliente.Os recursos de consentimento para aumento 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 das APIs de assinatura foram descontinuadas. Para mais informações, consulte Descontinuação da API Subscription.
Novos recursos
Os novos campos a seguir estão disponíveis em SubscriptionPurchaseV2:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
O método
subscriptionsv2.revokeagora oferece a opçãoitem_based_refund.
Outras alterações
- O parâmetro subscriptionId é opcional nas APIs purchases.subscriptions.