- Solicitud HTTP
- Parámetros de ruta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- DefiniteTransition
- TentativeTransition
- Pruébalo
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 |
Obligatorio. Es el paquete de la aplicación para la que se compró la suscripción (por ejemplo, "com.alguna.cosa"). |
token |
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 ( |
| Campos | |
|---|---|
productId |
Obligatorio. Es el producto de suscripción (por ejemplo, "plan_premium") para el que se debe programar la transición. |
earliestTransitionEffectiveTime |
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: |
| [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 |
Cuando se usa este modo, la transición del usuario al nuevo plan es definitiva y no se puede cancelar. |
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 |
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 ( |
| Campos | |
|---|---|
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.