Method: purchases.subscriptionsv2.scheduleplantransition

Planifier une transition de forfait pour un abonnement.

Requête HTTP

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

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.some.thing").

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
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
Champs
productId

string

Obligatoire. Produit sur abonnement (par exemple, "premium_plan") pour lequel la transition doit être planifiée.

earliestTransitionEffectiveTime

string (Timestamp format)

Obligatoire. Date et heure les plus précoces auxquelles la transition de forfait peut prendre effet. La transition effective aura lieu au moment du renouvellement, à cette date ou après.

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

[Obligatoire] Mode de transition du forfait. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
definiteTransition

object (DefiniteTransition)

Lorsque vous utilisez ce mode, la transition de l'utilisateur vers le nouveau forfait est définitive et ne peut pas être annulée.

tentativeTransition

object (TentativeTransition)

Lorsque vous utilisez ce mode, la transition de l'utilisateur vers le nouveau forfait est provisoire et peut être annulée.

Fin des champs mutuellement exclusifs.
etag

string

Si cette option est définie, 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.

Corps de la réponse

Réponse pour l'API purchases.subscriptionsv2.schedulePlanTransition.

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

Représentation JSON
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
Champs
planTransitionDetails

object (PlanTransitionDetails)

Détails de la transition du forfait de l'élément d'abonnement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

DefiniteTransition

Ce type ne comporte aucun champ.

Utilisé pour indiquer que la transition du forfait est définitive.

TentativeTransition

Ce type ne comporte aucun champ.

Utilisé pour indiquer que la transition du forfait est provisoire.