Method: purchases.subscriptions.defer

Difiere la compra de una suscripción del usuario hasta una fecha 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 de acceso

Parámetros
packageName

string

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

string

Es el ID de la suscripción que se compró (por ejemplo, "mensual001").
token

string

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

Es la 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 la nueva hora de vencimiento para la suscripción en milisegundos desde la época.

Muestra

La siguiente es una solicitud de ejemplo:

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 alcance 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 una hora de vencimiento futura.

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

string (int64 format)

Es la hora de vencimiento esperada para la suscripción. Si la hora de vencimiento actual para la suscripción no es el valor que se especifica aquí, no ocurrirá el aplazamiento.
desiredExpiryTimeMillis

string (int64 format)

Es la siguiente hora de vencimiento deseada 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.