Method: purchases.subscriptionsv2.scheduleplantransition

Programa una transición de plan para una suscripción.

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
packageName

string

Obligatorio. Es el paquete de la aplicación para la que se compró la suscripción (por ejemplo, "com.alguna.cosa").

token

string

Obligatorio. Es el token que se proporcionó para el dispositivo del usuario cuando se compró la suscripción.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Campos
productId

string

Obligatorio. Es el producto de suscripción (por ejemplo, "plan_premium") para el que se debe programar la transición.

earliestTransitionEffectiveTime

string (Timestamp format)

Obligatorio. Es la primera fecha y hora en la que podría llevarse a cabo la transición del plan. La transición real se realizará en el momento de la renovación, que puede coincidir con la primera fecha y hora o ser posterior.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

[Obligatorio] Es el modo de la transición del plan. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
definiteTransition

object (DefiniteTransition)

Cuando se usa este modo, la transición del usuario al nuevo plan es definitiva y no se puede cancelar.

tentativeTransition

object (TentativeTransition)

Cuando se usa este modo, la transición del usuario al nuevo plan es tentativa y se puede cancelar.

Fin de los campos mutuamente excluyentes.
etag

string

Si se configura, la API fallará en el caso de que la ETag no coincida con la ETag más reciente para esta suscripción. La ETag se recupera de purchases.subscriptionsv2.get: https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

Cuerpo de la respuesta

Es la respuesta para la API de purchases.subscriptionsv2.schedulePlanTransition.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Campos
planTransitionDetails

object (PlanTransitionDetails)

Son los detalles de la transición del plan del elemento de suscripción.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/androidpublisher

DefiniteTransition

Este tipo no tiene campos.

Se usa para indicar que la transición del plan es definitiva.

TentativeTransition

Este tipo no tiene campos.

Se usa para indicar que la transición del plan es tentativa.