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

Notas de la versión de la API de Google Play Developer

Este documento contiene las notas de la versión de las APIs de Google Play Developer.

19 de mayo de 2026

ID de pedido pendiente: La API de SubscriptionPurchaseV2 ahora incluye onHoldStateContext y inGracePeriodStateContext campos. Estos campos proporcionan detalles adicionales, como el ID de pedido pendiente o fallido, cuando una suscripción ingresa al estado ON_HOLD o IN_GRACE_PERIOD debido a un pago de renovación rechazado.

Algunas de las APIs de suscripciones están obsoletas. Para obtener más información, consulta Baja de la API de Subscription de mayo de 2026.

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 ahora está disponible para suscripciones individuales y suscripciones con complementos a través del purchases.subscriptionsv2.defer método. 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 durante el período especificado.
OfferPhase: El campo OfferPhase ahora está disponible en la API de SubscriptionPurchaseV2. Este campo proporciona la fase de oferta actual de la suscripción como uno de los períodos prorrateados, la prueba gratuita, el precio de lanzamiento y el precio del plan básico.

Manejo mejorado de la resuscripción.
- El campo outOfAppPurchaseContext ahora está disponible en SubscriptionPurchaseV2, lo que ayuda a vincular las compras de resuscripción realizadas desde Play Store proporcionando detalles de la suscripción vencida.
- El método purchases.subscriptions.acknowledge ahora acepta opcional externalAccountId en el cuerpo de la solicitud, lo que te permite asociar la compra de resuscripción con tus identificadores de usuario.
El campo SubscriptionPurchaseLineItem.itemReplacement ahora 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.

La API de SubscriptionPurchaseV2 ahora proporciona el método cancel.

Este método proporciona una mejora con respecto a la funcionalidad existente purchases.subscriptions.cancel, ya que introduce compatibilidad con el parámetro cancellationType en 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.

Algunas de las APIs de suscripciones están obsoletas. Para obtener más información, consulta Baja de la API de Subscription.

Los siguientes campos nuevos están disponibles en SubscriptionPurchaseV2:
- SubscriptionPurchaseLineItem.latest_successful_order_id
- PriceChangeState.CANCELED
El método subscriptionsv2.revoke ahora proporciona la opción item_based_refund.
La API de Orders ahora proporciona los métodos get y batchGet.

El parámetro subscriptionId es opcional en las APIs de purchases.subscriptions.