Method: purchases.subscriptions.defer

Obsoleto: Usa purchases.subscriptionsv2.defer en su lugar. Difiere la compra de la suscripción de un usuario hasta una hora de vencimiento futura especificada.

Solicitud HTTP

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

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

Parámetros de ruta

Parámetros
packageName

string

Es el nombre del paquete de la aplicación para la que se compró esta suscripción (por ejemplo, "com.some.thing").
subscriptionId

string

Es el ID de la suscripción comprada (por ejemplo, "monthly001").
token

string

Es el token que se envió 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 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Campos
deferralInfo

object (SubscriptionDeferralInfo)

Es la información sobre la nueva hora de vencimiento deseada para la suscripción.

Cuerpo de la respuesta

Respuesta para la API de purchases.subscriptions.defer.

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

Representación JSON 
{
  "newExpiryTimeMillis": string
}
Campos
newExpiryTimeMillis

string (int64 format)

Es el nuevo tiempo de vencimiento para la suscripción en milisegundos desde la época.

Muestra

La siguiente es una solicitud de de muestra:

curl -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "deferralInfo": {
      "desiredExpiryTimeMillis": "1735689600000",
      "expectedExpiryTimeMillis": "1704067200000"
    }
  }' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'

A continuación, se muestra una respuesta de ejemplo:

{
  "newExpiryTimeMillis": "1776004800000"
}

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

SubscriptionDeferralInfo

El campo SubscriptionDeferralInfo contiene los datos necesarios para diferir la compra de una suscripción a un tiempo de vencimiento futuro.

Representación JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Campos
expectedExpiryTimeMillis

string (int64 format)

Es el tiempo de vencimiento esperado para la suscripción. Si la hora de vencimiento actual de la suscripción no es el valor especificado aquí, no se producirá la postergación.
desiredExpiryTimeMillis

string (int64 format)

Es el siguiente tiempo de vencimiento deseado que se debe asignar a la suscripción, en milisegundos desde la época. La hora especificada debe ser posterior a la hora de vencimiento actual para la suscripción.