- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- DefiniteTransition
- TentativeTransition
- Essayer
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 |
Obligatoire. Package de l'application pour laquelle cet abonnement a été acheté (par exemple, "com.some.thing"). |
token |
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 ( |
| Champs | |
|---|---|
productId |
Obligatoire. Produit sur abonnement (par exemple, "premium_plan") pour lequel la transition doit être planifiée. |
earliestTransitionEffectiveTime |
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 : |
| [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 |
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 |
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 |
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 ( |
| Champs | |
|---|---|
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.