Este documento contiene las notas de la versión de las APIs de Google Play Developer.
19 de noviembre de 2026
Funciones nuevas
Ofertas de retención: Ahora puedes crear ofertas de retención que Google Play muestra a los suscriptores que cumplen con los requisitos cuando intentan cancelar la suscripción.
- Segmentación por retención: Para crear o actualizar una oferta de retención con el método
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchomonetization.subscriptions.basePlans.offers.batchUpdate, estableceretentionRuleen el campotargetingde la oferta en un objetoRetentionTargetingRule. Usa los camposscope,minDuration,allowMultipleClaimsyminOfferCooldownDurationpara definir qué suscriptores son aptos y si pueden canjear la oferta más de una vez. - Período de disponibilidad de la oferta: El recurso
SubscriptionOfferahora incluye los campos opcionalesstartTimeyendTimeque establecen cuándo una oferta, como una oferta de retención, está disponible y cuándo deja de estarlo. - Segmentación por usuario: Para que una oferta de retención esté disponible solo para
suscriptores específicos, establece
retentionPerUserRule(RetentionPerUserTargetingRule) en el campotargetingde la oferta. Para segmentar la oferta a una suscripción, llama al métodopurchases.subscriptionsv2.activateOfferTargetingconpurchaseTokenyofferId. Para quitar la segmentación, llama al métodopurchases.subscriptionsv2.deactivateOfferTargeting. El recurso SubscriptionPurchaseV2 enumera las ofertas que se orientan a cada elemento de línea en el campodeveloperTargetedOffers, incluidos los valoresofferIdyactivateTimede cada oferta. - Notificaciones de transición de plan: Se envía un nuevo tipo de RTDN de suscripción,
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21), cuando un suscriptor acepta una oferta de retención. - Detalles de la transición del plan: El recurso SubscriptionPurchaseV2 ahora incluye un objeto
planTransitionDetailsenautoRenewingPlan. Identifica la oferta de retención aceptada enofferIdy, además, informa el estado de transición entransitionInfo.
- Segmentación por retención: Para crear o actualizar una oferta de retención con el método
Validación de ETag para la cancelación y revocación de suscripciones: Los métodos
purchases.subscriptionsv2.cancelypurchases.subscriptionsv2.revokeahora admiten un campoetagopcional enCancellationContextyRevocationContext. Usa el campoetagpara evitar conflictos cuando varias solicitudes modifican la misma suscripción al mismo tiempo. Obtén el valoretagdel campoetagde nivel superior que devolvió tu llamadapurchases.subscriptionsv2.getmás reciente.
6 de julio de 2026
Funciones nuevas
Actualizaciones sobre la responsabilidad por los costos de devolución de cargos: Google Play ahora admite un proceso de impugnación de devolución de cargos colaborativa.
Notificaciones de revisión de reembolsos pendientes: Se envía un nuevo tipo de notificación para desarrolladores en tiempo real (RTDN),
PendingRefundReviewNotification, cuando un usuario solicita una devolución del cargo que requiere tu revisión. Las revisiones pendientes solo admitenCHARGEBACKcomo motivo del reembolso.API de ReviewRefund: Puedes evaluar estas solicitudes y responder en un plazo de 24 horas llamando a la nueva API de
orders.reviewrefund. En la llamada a la API, debes proporcionar una preferencia de reembolso (comoAPPROVE,DECLINEoNEUTRAL) y cualquier evidencia relevante del uso de la compra (como la dirección IP del usuario, el porcentaje de consumo acumulado y la ubicación geográfica aproximada) para ayudar a Google Play a disputar la devolución del cargo.
19 de mayo de 2026
Funciones nuevas
- ID de pedido pendiente: La API de SubscriptionPurchaseV2 ahora incluye los campos
onHoldStateContextyinGracePeriodStateContext. Estos campos proporcionan detalles adicionales, como el ID de pedido pendiente o con errores, cuando una suscripción ingresa al estadoON_HOLDoIN_GRACE_PERIODdebido a un pago de renovación rechazado.
Bajas
- Algunas de las APIs de suscripciones están obsoletas. Para obtener más información, consulta Baja de la API de Subscription en mayo de 2026.
27 de enero de 2026
Funciones nuevas
Aplazamiento de suscripciones con complementos: Anteriormente, la API de Google Play Developer permitía aplazar la facturación solo para suscripciones individuales. La función de aplazamiento ya está disponible para suscripciones individuales y suscripciones con complementos a través del método
purchases.subscriptionsv2.defer. Cuando aplazas la fecha de facturación de una suscripción con complementos, la fecha de facturación de todos los elementos de la suscripción se aplaza por la duración especificada.OfferPhase: El campo
OfferPhaseya está disponible en la API de SubscriptionPurchaseV2. Este campo proporciona la fase de oferta actual de la suscripción como uno de los siguientes: período prorrateado, prueba gratuita, precio de lanzamiento y precio del plan básico.
19 de noviembre de 2025
Funciones nuevas
Mejoras en el manejo de la renovación de suscripciones.
- El campo
outOfAppPurchaseContextya está disponible en SubscriptionPurchaseV2, lo que ayuda a vincular las compras de renovaciones de suscripciones realizadas desde Play Store, ya que proporciona detalles de la suscripción vencida. - El método purchases.subscriptions.acknowledge ahora acepta un parámetro
externalAccountIdopcional en el cuerpo de la solicitud, lo que te permite asociar la compra de la nueva suscripción con tus identificadores de usuario.
- El campo
El campo
SubscriptionPurchaseLineItem.itemReplacementya está disponible en SubscriptionPurchaseV2, que ofrece detalles sobre el elemento que se reemplaza, si corresponde.La API de Orders ahora incluye el campo
offerPhaseDetails, que proporciona información más detallada sobre los pedidos que financian un período prorrateado.
11 de septiembre de 2025
Funciones nuevas
La API de SubscriptionPurchaseV2 ahora proporciona el método
cancel.Este método mejora la funcionalidad existente de purchases.subscriptions.cancel, ya que introduce compatibilidad con el parámetro
cancellationTypeen las bibliotecas cliente.Las siguientes funciones de consentimiento para el aumento gradual del precio están disponibles:
Se agregó un campo nuevo en SubscriptionPurchaseV2:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.Se encuentra disponible un nuevo tipo de notificación para desarrolladores en tiempo real: SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.
30 de junio de 2025
Funciones nuevas
- Ya está disponible la nueva API de ProductPurchaseV2, que admite varias opciones de compra y ofertas para productos únicos.
21 de mayo de 2025
Bajas
- Algunas de las APIs de suscripciones están obsoletas. Para obtener más información, consulta Baja de la API de Subscription.
Funciones nuevas
Los siguientes campos nuevos están disponibles en SubscriptionPurchaseV2:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
El método
subscriptionsv2.revokeahora proporciona la opciónitem_based_refund.La API de Orders ahora proporciona los métodos
getybatchGet.
Otros cambios
- El parámetro subscriptionId es opcional en las APIs de purchases.subscriptions.