Method: purchases.subscriptionsv2.defer

Aplaza la renovación de una suscripción.

Solicitud HTTP

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

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ó al 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 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Campos
deferralContext

object (DeferralContext)

Obligatorio. Son los detalles sobre el aplazamiento de la suscripción.

Cuerpo de la respuesta

Es la respuesta para la API de purchases.subscriptions.defer de la versión 2.

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

Representación JSON 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Campos
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

Es la nueva fecha y hora de vencimiento de cada elemento de suscripción.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

DeferralContext

Es el contexto de aplazamiento de la API de purchases.subscriptionsv2.defer.

Representación JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Campos
etag

string

Obligatorio. Se producirá un error en la API si la ETag no coincide con la 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
deferDuration

string (Duration format)

Obligatorio. Es la duración por la que se deben aplazar todos los elementos de la suscripción.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
validateOnly

boolean

Si se establece en "true", la solicitud es una ejecución de prueba para validar el efecto de subscriptionsv2.defer, por lo que la suscripción no se verá afectada.

ItemExpiryTimeDetails

Son los detalles de la hora de vencimiento de un elemento de suscripción.

Representación JSON 
{
  "productId": string,
  "expiryTime": string
}
Campos
productId

string

Es el ID del producto del elemento de suscripción (por ejemplo, "premium_plan").
expiryTime

string (Timestamp format)

Es la nueva fecha de vencimiento de este elemento de suscripción.

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".