Method: purchases.subscriptions.defer

Obsolète : utilisez plutôt purchases.subscriptionsv2.defer. Reporte l'achat d'un abonnement par un utilisateur jusqu'à une date d'expiration future spécifiée.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
packageName

string

Nom de package de l'application pour laquelle cet abonnement a été acheté (par exemple, "com.exemple.XXX").
subscriptionId

string

ID de l'abonnement acheté (par exemple, "mensuel001").
token

string

Jeton fourni à l'appareil de l'utilisateur lors de la souscription de l'abonnement.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
Champs
deferralInfo

object (SubscriptionDeferralInfo)

Informations sur le nouveau délai d'expiration souhaité pour l'abonnement.

Corps de la réponse

Réponse pour l'API purchases.subscriptions.defer.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "newExpiryTimeMillis": string
}
Champs
newExpiryTimeMillis

string (int64 format)

Nouveau délai d'expiration de l'abonnement en millisecondes depuis l'epoch.

Échantillon

Voici un exemple de requête :

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'

Voici un exemple de réponse :

{
  "newExpiryTimeMillis": "1776004800000"
}

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

SubscriptionDeferralInfo

SubscriptionDeferralInfo contient les données nécessaires pour différer un achat d'abonnement à une date d'expiration ultérieure.

Représentation JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
Champs
expectedExpiryTimeMillis

string (int64 format)

Heure d'expiration prévue de l'abonnement. Si la date d'expiration actuelle de l'abonnement n'est pas celle spécifiée ici, le report n'aura pas lieu.
desiredExpiryTimeMillis

string (int64 format)

Prochaine date d'expiration souhaitée à attribuer à l'abonnement, en millisecondes depuis l'epoch. L'heure indiquée doit être postérieure à l'heure d'expiration actuelle de l'abonnement.