- Ressource: Abonnement
- BasePlan
- État
- AutoRenewingBasePlanType
- ResubscribeState
- SubscriptionProrationMode (Mode de propagation de l'abonnement)
- PrepaidBasePlanType
- TimeExtension.
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- Fiche par abonnement
- Méthodes
Ressource : Subscription
Un seul abonnement pour une application.
Représentation JSON |
---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
Champs | |
---|---|
packageName |
Immuable. Nom de package de l'application parente. |
productId |
Immuable. ID produit unique du produit. Unique dans l'application parente. Les ID produit doivent être composés de lettres minuscules (a-z), de chiffres (0-9), de traits de soulignement (_) et de points (.). Ils doivent commencer par une lettre minuscule ou un chiffre et doivent comporter entre 1 et 40 caractères (inclus). |
basePlans[] |
Ensemble de forfaits de base pour cet abonnement. Prix et durée de l'abonnement si aucune autre offre ne s'applique. |
listings[] |
Obligatoire. Liste des fiches localisées de cet abonnement. Doit contenir au moins une entrée pour la langue par défaut de l'application parente. |
archived |
Uniquement en sortie. Indique si cet abonnement est archivé. Les abonnements archivés ne sont plus disponibles pour les abonnés, ne peuvent plus être mis à jour et ne sont pas renvoyés dans les requêtes de liste à moins que l'indicateur d'archivage archivé ne soit transmis. |
taxAndComplianceSettings |
Informations sur les taxes et la conformité aux lois |
Forfait de base
Un forfait de base unique pour un abonnement.
Représentation JSON |
---|
{ "basePlanId": string, "state": enum ( |
Champs | |
---|---|
basePlanId |
Obligatoire. Immuable. Identifiant unique de ce forfait de base. Doit être unique dans l'abonnement et respecter la norme RFC-1034. Autrement dit, cet ID ne peut contenir que des lettres minuscules (a-z), des chiffres (0-9) et des traits d'union (-), et ne doit pas dépasser 63 caractères. |
state |
Uniquement en sortie. État du forfait de base, à savoir s'il est actif. Vous pouvez activer ou supprimer les plans de base inactifs et en brouillon. Les forfaits de base actifs peuvent être désactivés. Les forfaits de base inactifs peuvent être annulés. Ce champ ne peut pas être modifié en mettant à jour la ressource. Utilisez plutôt les points de terminaison dédiés. |
regionalConfigs[] |
Informations spécifiques à la région pour ce forfait de base. |
offerTags[] |
Liste de 20 tags personnalisés spécifiés au maximum pour ce forfait de base, renvoyée à l'application via la bibliothèque de facturation. Les offres d'abonnement de ce forfait de base recevront également ces tags d'offre dans la bibliothèque de facturation. |
otherRegionsConfig |
Les informations tarifaires des nouveaux lieux que Play est susceptible de proposer à l'avenir. S'il est omis, le BasePlan ne sera pas automatiquement disponible pour les nouveaux lieux que Play pourrait lancer à l'avenir. |
Champ d'union base_plan_type . Type de forfait de base. Vous devez en définir un seul. base_plan_type ne peut être qu'un des éléments suivants : |
|
autoRenewingBasePlanType |
Défini lorsque le forfait de base est renouvelé automatiquement à intervalle régulier. |
prepaidBasePlanType |
Défini lorsque le forfait de base n'est pas renouvelé automatiquement à la fin de la période de facturation. |
State
État actuel d'un forfait de base.
Enums | |
---|---|
STATE_UNSPECIFIED |
État non spécifié. |
DRAFT |
Le forfait de base est actuellement à l'état de brouillon et n'a pas été activé. À ce stade, vous pouvez le supprimer en toute sécurité. |
ACTIVE |
Le forfait de base est actif et disponible pour les nouveaux abonnés. |
INACTIVE |
Le forfait de base est inactif et réservé aux abonnés existants. |
Renouvellement automatique du forfait de base
Représente un forfait de base qui se renouvelle automatiquement à la fin de sa période d'abonnement.
Représentation JSON |
---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "resubscribeState": enum ( |
Champs | |
---|---|
billingPeriodDuration |
Obligatoire. Période d'abonnement, spécifiée au format ISO 8601. Pour obtenir la liste des périodes de facturation acceptées, consultez le centre d'aide. |
gracePeriodDuration |
Délai de grâce de l'abonnement, spécifié au format ISO 8601. Valeurs autorisées : P0D (zéro jour), P3D (3 jours), P7D (7 jours), P14D (14 jours) et P30D (30 jours). Si aucune valeur n'est spécifiée, une valeur par défaut sera utilisée en fonction de la durée de la période récurrente. |
resubscribeState |
Indique si les utilisateurs doivent pouvoir se réabonner à ce forfait de base sur les surfaces Google Play. S'il n'est pas spécifié, la valeur par défaut est RESUBSCRIBE_STATE_ACTIVE. |
prorationMode |
Le mode de calcul au prorata pour le forfait de base détermine ce qui se passe lorsqu'un utilisateur passe de ce forfait à un autre. Si aucune valeur n'est spécifiée, la valeur par défaut est CHARGE_ON_NEXT_BILLING_DATE. |
legacyCompatible |
Indique si le forfait de base renouvelé est rétrocompatible. Le forfait de base rétrocompatible est renvoyé par la méthode abandonnée querySkuDetailsAsync() de la Bibliothèque Google Play Billing. Un seul forfait de base renouvelé peut être marqué comme étant compatible avec un ancien abonnement pour un abonnement donné. |
legacyCompatibleSubscriptionOfferId |
ID de l'offre d'abonnement compatible avec les anciennes versions. L'offre d'abonnement rétrocompatible est renvoyée par la méthode abandonnée querySkuDetailsAsync() de la Bibliothèque Google Play Billing. Une seule offre d'abonnement peut être marquée comme étant compatible avec les anciennes versions pour un forfait de base renouvelé. Pour qu'aucune offre d'abonnement ne soit compatible avec les anciennes versions, définissez ce champ en tant que chaîne vide. |
Se réabonner
État de réabonnement du forfait de base.
Enums | |
---|---|
RESUBSCRIBE_STATE_UNSPECIFIED |
État non spécifié. |
RESUBSCRIBE_STATE_ACTIVE |
Le réabonnement est actif. |
RESUBSCRIBE_STATE_INACTIVE |
Le réabonnement est inactif. |
Mode d'abonnement
Mode de calcul au prorata utilisé pour le renouvellement des forfaits de base.
Enums | |
---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
Mode non spécifié. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
Le nouveau forfait de base sera facturé aux utilisateurs à la fin de la période de facturation en cours. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
Le nouveau forfait de base sera facturé immédiatement et intégralement aux utilisateurs. Les périodes d'abonnement restantes seront utilisées pour prolonger la durée du nouveau forfait. |
Forfait de base prépayé
Représente un forfait de base qui ne se renouvelle pas automatiquement à la fin du forfait de base et doit être renouvelé manuellement par l'utilisateur.
Représentation JSON |
---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
Champs | |
---|---|
billingPeriodDuration |
Obligatoire. Période d'abonnement, spécifiée au format ISO 8601. Pour obtenir la liste des périodes de facturation acceptées, consultez le centre d'aide. |
timeExtension |
Indique si les utilisateurs doivent pouvoir prolonger ce forfait de base prépayé sur les surfaces Google Play. Si aucune valeur n'est spécifiée, la valeur par défaut est TIME_EXTENSION_ACTIVE. |
Extension de temps
Extension du forfait de base.
Enums | |
---|---|
TIME_EXTENSION_UNSPECIFIED |
État non spécifié. |
TIME_EXTENSION_ACTIVE |
L'extension de temps est active. Les utilisateurs sont autorisés à créditer ou prolonger leur forfait prépayé. |
TIME_EXTENSION_INACTIVE |
L'extension de temps est inactive. Les utilisateurs ne peuvent pas créditer ni prolonger leur forfait prépayé. |
Plan de base régional
Configuration d'un forfait de base spécifique à une région.
Représentation JSON |
---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"price": {
object ( |
Champs | |
---|---|
regionCode |
Obligatoire. Code régional auquel cette configuration s'applique, tel que défini par la norme ISO 3166-2, par exemple "US". |
newSubscriberAvailability |
Indique si le forfait de base dans la région spécifiée est disponible pour les nouveaux abonnés. L'abonnement des abonnés existants ne sera pas annulé si cette valeur est définie sur "false". S'il n'est pas spécifié, la valeur par défaut est "false". |
price |
Prix du forfait de base dans la région spécifiée. Doit être défini si le forfait de base est disponible pour les nouveaux abonnés. Doit être défini dans la devise associée à la région spécifiée. |
AutreRégionBaseBaseConfig
Informations tarifaires pour tout nouveau pays dans lequel Play est disponible
Représentation JSON |
---|
{ "usdPrice": { object ( |
Champs | |
---|---|
usdPrice |
Obligatoire. Prix en USD à utiliser pour tous les nouveaux lieux de lancement de Play. |
eurPrice |
Obligatoire. Prix en EUR pour les nouveaux pays de lancement de Play. |
newSubscriberAvailability |
Indique si le forfait de base est disponible pour les nouveaux abonnés dans tous les nouveaux pays où Play est disponible. S'il n'est pas spécifié, la valeur par défaut est "false". |
ListeAbonnements
Métadonnées visibles par le consommateur d'un abonnement.
Représentation JSON |
---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
Champs | |
---|---|
languageCode |
Obligatoire. Langue de cette fiche, telle que définie par le standard BCP-47, par exemple "en-US". |
title |
Obligatoire. Titre de l'abonnement dans la langue de la fiche. Texte brut. |
benefits[] |
Liste des avantages présentés à l'utilisateur sur des plates-formes telles que le Play Store et dans les flux de restauration dans le langage de cette fiche. Texte brut. Liste ordonnée de quatre avantages au maximum. |
description |
Description de cet abonnement dans la langue de cette fiche. Longueur maximale : 80 caractères. Texte brut. |
Méthodes |
|
---|---|
|
Permet d'archiver un abonnement. |
|
Crée un abonnement. |
|
Supprime un abonnement. |
|
Lit un seul abonnement. |
|
Répertorie tous les abonnements d'une application donnée. |
|
Met à jour un abonnement existant. |