Bajas

En este documento, se enumeran las APIs de Google Play Developer y las funciones relacionadas que se encuentran en un período de baja.

Cronograma de baja: del 21 de mayo de 2025 al 31 de agosto de 2027

Las funciones y las APIs de esta sección dejarán de estar disponibles a partir del 21 de mayo de 2025 y se cerrarán el 31 de agosto de 2027. Sin embargo, puedes obtener una extensión para los elementos obsoletos hasta el 1 de noviembre de 2027.

APIs de suscripción obsoletas

En esta sección, se enumeran las baja de las APIs.

API Reemplazo disponible
subscriptions.get subscriptionsv2.get
subscriptions.refund Llama a subscriptionsv2.get para obtener SubscriptionPurchaseLineItem. latest_successful_order_id y, luego, llama a Orders.refund para reembolsar los pedidos.
subscriptions.revoke subscriptionsv2.revoke
SubscriptionPurchaseV2. latestOrderId SubscriptionPurchaseLineItem. latest_successful_order_id
RealTimeDeveloperNotification. SubscriptionNotification.subscriptionId Sin reemplazo
RealTimeDeveloperNotification. SubscriptionNotification. notificationType SUBSCRIPTION_PRICE_CHANGE_CONFIRMED SUBSCRIPTION_PRICE _CHANGE_UPDATED

Campos de SubscriptionPurchaseV2 para suscripciones recurrentes

purchases.subscriptionv2 contiene campos nuevos que proporcionan más detalles sobre los nuevos objetos de suscripción. En la siguiente tabla, se muestra la asignación de los campos del extremo de suscripción heredado a los campos correspondientes en purchases.subscriptionv2.

SubscriptionPurchase SubscriptionPurchaseV2
countryCode regionCode
orderId SubscriptionPurchaseLineItem.latest_successful_order_id
(sin campo equivalente) lineItems (lista de SubscriptionPurchaseLineItem) que representa los productos adquiridos con la compra
(sin campo equivalente) lineItems.offerDetails.basePlanId
(sin campo equivalente) lineItems.offerDetails.offerId
(sin campo equivalente) lineItems.offerDetails.offerTags
startTimeMillis startTime
expiryTimeMillis lineItems.expiryTime (cada suscripción adquirida en la compra tiene su propio expiryTime)
(sin campo equivalente) subscriptionState (indica el estado de la suscripción)
(sin campo equivalente) pausedStateContext (solo presente si el estado de la suscripción es SUBSCRIPTION_STATE_PAUSED)
autoResumeTimeMillis pausedStateContext.autoResumeTime
(sin campo equivalente) canceledStateContext (solo presente si el estado de la suscripción es SUBSCRIPTION_STATE_CANCELED)
(sin campo equivalente) testPurchase (solo presente en compras de verificadores con licencia)
autoRenewing lineItems.autoRenewingPlan.autoRenewEnabled
priceCurrenceCode, priceAmountMicros lineItems.autoRenewingPlan.recurringPrice
introductoryPriceInfo (sin campo equivalente)
Esta información se puede encontrar en offer de cada una de las suscripciones compradas.
developerPayload (sin campo equivalente) la carga útil para desarrolladores dejó de estar disponible
paymentState (sin campo equivalente)
Puedes deducir el estado de pago a partir de subscriptionState:
  • El pago está pendiente:
    • SUBSCRIPTION_STATE_PENDING (compras nuevas con transacción pendiente)
    • SUBSCRIPTION_STATE_IN_GRACE_PERIOD
    • SUBSCRIPTION_STATE_ON_HOLD
  • Se recibió el pago:
    • SUBSCRIPTION_STATE_ACTIVE
  • Prueba gratuita:
    • El campo Order.line_items.subscription_details.offer_phase, que puedes recuperar con la API de Orders.get
  • Actualización o cambio a versión inferior postergada:
    • SUBSCRIPTION_STATE_PENDING
cancelReason, userCancellationTimeMillis, cancelSurveyResult canceledStateContext
linkedPurchaseToken linkedPurchaseToken (sin cambios)
purchaseType Prueba: a través de testPurchase
Promoción: signupPromotion
priceChange lineItems.autoRenewingPlan.priceChangeDetails
profileName, emailAddress, givenName, familyName, profileId subscribeWithGoogleInfo
acknowledgementState acknowledgementState (no change)
promotionType, promotionCode signupPromotion
externalAccountId, obfuscatedExternalAccountId, obfuscatedExteranlProfileId externalAccountIdentifiers

Otras funciones de administración de suscripciones

Aunque purchases.subscriptions:get se actualizó a purchases.subscriptionsv2:get, el resto de las funciones de administración de suscripciones de desarrollador permanecerán sin cambios por ahora en el extremo purchases.subscriptions, de manera que puedes seguir usando purchases.subscriptions:acknowledge, purchases.subscriptions:cancel, purchases.subscriptions:defer, purchases.subscriptions:refund y purchases.subscriptions:revoke como lo hacías antes.