Method: purchases.subscriptionsv2.defer

Reporte le renouvellement d'un abonnement.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
packageName

string

Obligatoire. Package de l'application pour laquelle cet abonnement a été acheté (par exemple, "com.exemple.XXX").
token

string

Obligatoire. 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 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
Champs
deferralContext

object (DeferralContext)

Obligatoire. Informations sur le report de l'abonnement.

Corps de la réponse

Réponse pour l'API v2 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 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
Champs
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

Nouvelle heure d'expiration pour chaque élément d'abonnement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

DeferralContext

Contexte de report de l'API purchases.subscriptionsv2.defer.

Représentation JSON 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
Champs
etag

string

Obligatoire. L'API échouera si l'etag ne correspond pas au dernier etag de cet abonnement. L'etag est récupéré à partir de purchases.subscriptionsv2.get : https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get.
deferDuration

string (Duration format)

Obligatoire. Durée pendant laquelle tous les éléments de l'abonnement doivent être reportés.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
validateOnly

boolean

Si la valeur est définie sur "true", la requête est une simulation pour valider l'effet de subscriptionsv2.defer. L'abonnement ne sera pas affecté.

ItemExpiryTimeDetails

Informations sur l'heure d'expiration d'un élément d'abonnement.

Représentation JSON 
{
  "productId": string,
  "expiryTime": string
}
Champs
productId

string

ID produit de l'article d'abonnement (par exemple, "premium_plan").
expiryTime

string (Timestamp format)

Nouvelle heure d'expiration de cet élément d'abonnement.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".