REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

Este tipo representa un objeto SubscriptionPurchaseV2 en el servicio androidpublisher.

string

Es el código de país o región de facturación ISO 3166-1 alfa-2 del usuario en el momento en que se otorgó la suscripción.

object (SubscriptionPurchaseLineItem)

Información a nivel del artículo para la compra de una suscripción. Los elementos de la misma compra deben estar todos con AutoRenewingPlan o todos con PrepaidPlan.

string (Timestamp format)

Hora en la que se otorgó la suscripción. No establecida para las suscripciones pendientes (se creó la suscripción, pero está pendiente del pago durante el registro).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

El estado actual de la suscripción.

string

Es el ID del pedido más reciente asociado con la compra de la suscripción. En el caso de la renovación automática de suscripciones, este es el ID de pedido del pedido de registro (si aún no se renovó) o el ID de pedido recurrente más reciente (pedido correcto, pendiente o rechazado). Para suscripciones prepagadas, es el ID de pedido asociado con el token de compra consultado.

string

El token de compra de la suscripción anterior si esta suscripción es uno de los siguientes: * Volver a registrar una suscripción cancelada pero no caducada * Actualizar o cambiar a una versión inferior de una suscripción anterior. * Pasa de una suscripción prepagada a una con renovación automática. * Convierte una suscripción con renovación automática en una suscripción prepagada. * Recarga una suscripción prepagada.

object (PausedStateContext)

Contexto adicional sobre las suscripciones detenidas Solo está presente si la suscripción actualmente tiene subscriptionState SUBSCRIPTION_STATE_PAused.

object (CanceledStateContext)

Contexto adicional sobre las suscripciones canceladas Solo está presente si la suscripción actualmente tiene subscriptionState SUBSCRIPTION_STATE_CANCELED o SUBSCRIPTION_STATE_EXPIRED.

object (TestPurchase)

Solo está presente si la compra de esta suscripción es una compra de prueba.

enum (AcknowledgementState)

Es el estado de confirmación de la suscripción.

object (ExternalAccountIdentifiers)

Es el identificador de cuenta de usuario en el servicio de terceros.

object (SubscribeWithGoogleInfo)

Perfil de usuario asociado con compras realizadas con "Suscríbete con Google".

{
  "autoResumeTime": string
}

string (Timestamp format)

Hora en la que se reanudará automáticamente la suscripción.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

El usuario canceló la suscripción.

object (SystemInitiatedCancellation)

El sistema canceló la suscripción (por ejemplo, debido a un problema de facturación).

object (DeveloperInitiatedCancellation)

El desarrollador canceló la suscripción.

object (ReplacementCancellation)

Se reemplazó la suscripción por una nueva.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

Información que proporciona el usuario cuando completa el flujo de cancelación de la suscripción (encuesta sobre el motivo de la cancelación).

string (Timestamp format)

Es la hora a la que el usuario canceló la suscripción. Es posible que, después de ese período, el usuario siga teniendo acceso a la suscripción. Usa lineItems.expiry_time para determinar si un usuario aún tiene acceso.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

El motivo que seleccionó el usuario en la encuesta de cancelación.

string

Solo se estableció para CANCEL_SURVEY_REASON_OTHERS. Es la respuesta en formato libre del usuario a la encuesta.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

Es el identificador de cuenta de usuario en el servicio de terceros. Solo está presente si se vinculó la cuenta como parte del flujo de compra de la suscripción.

string

Es una versión ofuscada del ID que está asociada de forma exclusiva con la cuenta del usuario en tu app. Presente en las siguientes compras: * Si se vinculó la cuenta como parte del flujo de compra de la suscripción. * Se especificó con https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid cuando se realizó la compra.

string

Es una versión ofuscada del ID que está asociado de forma exclusiva con el perfil del usuario en tu app. Solo está presente si se especifica con https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid cuando se realizó la compra.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

Es el ID de perfil de Google del usuario cuando se compró la suscripción.

string

Es el nombre del perfil del usuario cuando se compró la suscripción.

string

Es la dirección de correo electrónico del usuario cuando se compró la suscripción.

string

Es el nombre del usuario cuando se compró la suscripción.

string

Es el nombre de familia del usuario cuando se compró la suscripción.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

Es el ID del producto comprado (por ejemplo, "mensual001").

string (Timestamp format)

Hora en la que la suscripción venció o vencerá, a menos que se extienda el acceso (p. ej., se renueve).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

El elemento se está renovando automáticamente.

object (PrepaidPlan)

El artículo está prepagado.

object (OfferDetails)

Son los detalles de la oferta de este artículo.

object (DeferredItemReplacement)

Información para el reemplazo diferido del artículo.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

Si la suscripción está configurada para renovarse automáticamente, p.ej., el usuario no canceló la suscripción

object (SubscriptionItemPriceChangeDetails)

Información del último cambio de precio del elemento desde que se registró la suscripción.

object (InstallmentPlan)

El compromiso del plan de cuotas y la información relacionada con el estado del plan con renovación automática.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

Nuevo precio recurrente para el elemento de suscripción.

enum (PriceChangeMode)

El modo de cambio de precio especifica los cambios en el precio del elemento de suscripción.

enum (PriceChangeState)

Indicar el cambio de precio se encuentra actualmente.

string (Timestamp format)

La fecha y hora de renovación en la que el cambio de precio entrará en vigencia para el usuario. Esto está sujeto a cambios(en el futuro) debido a casos en los que el horario de renovación cambie, como una pausa. Este campo solo se completa si no entra en vigencia el cambio de precio.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

Cantidad total de pagos por los que se compromete inicialmente el usuario.

integer

Cantidad total de pagos que se comprometerán al usuario después de cada período de compromiso. Si está vacío, el plan de cuotas volverá a ser una suscripción con renovación automática normal después del compromiso inicial.

integer

Cantidad total de pagos comprometidos que quedan por pagar en este ciclo de renovación.

object (PendingCancellation)

Si existe, este plan de cuotas está pendiente de cancelación. La cancelación se producirá solo después de que el usuario finalice todos los pagos comprometidos.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Si está presente, es el tiempo después del cual se permiten las compras de recarga para el plan prepagado. No estará presente para los planes prepagados vencidos.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

Las etiquetas de la oferta más recientes asociadas con la oferta. Incluye las etiquetas heredadas del plan básico.

string

El ID del plan básico. Presente para todos los planes básicos y las ofertas.

string

Es el ID de la oferta. Solo está presente para las ofertas con descuento.

{
  "productId": string
}

string

El productId que reemplazará al productId existente.