Method: purchases.subscriptions.defer

Reporte l'achat d'un abonnement d'un utilisateur jusqu'à une date d'expiration ultérieure 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 du package de l'application pour laquelle cet abonnement a été acheté (par exemple, "com.un.truc").
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 la nouvelle date d'expiration souhaitée 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

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

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

string (int64 format)

Date d'expiration prévue de l'abonnement. Si la date d'expiration actuelle de l'abonnement ne correspond pas à la valeur spécifiée ici, le report ne sera pas effectué.
desiredExpiryTimeMillis

string (int64 format)

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