REST Resource: monetization.subscriptions

{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}

string

Immuable. Nom du package de l'application parente.

string

Immuable. Identifiant unique du produit. Unique dans l'application parente. Les identifiants 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 comporter entre 1 et 40 caractères (inclus).

object (BasePlan)

Ensemble des forfaits de base pour cet abonnement. Représente les prix et la durée de l'abonnement si aucune autre offre ne s'applique.

object (SubscriptionListing)

Obligatoire. Liste des fiches localisées pour cet abonnement. Doit contenir au moins une entrée pour la langue par défaut de l'application parente.

boolean

Uniquement en sortie. Indique si cet abonnement est archivé. Les abonnements archivés ne sont plus accessibles aux abonnés, ne peuvent plus être mis à jour et ne sont pas renvoyés dans les requêtes de liste, sauf si l'indicateur d'affichage des éléments archivés est transmis.

object (SubscriptionTaxAndComplianceSettings)

Informations sur les taxes et la conformité réglementaire

{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}

string

Obligatoire. Immuable. Identifiant unique de ce forfait de base. Doit être unique dans l'abonnement et conforme à la norme RFC-1034. Autrement dit, cet identifiant 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.

enum (State)

Uniquement en sortie. État du forfait de base, c'est-à-dire s'il est actif. Les forfaits de base inactifs et brouillons peuvent être activés ou supprimés. Les forfaits de base actifs peuvent devenir inactifs. 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.

object (RegionalBasePlanConfig)

Informations spécifiques à la région pour ce forfait de base.

object (OfferTag)

Liste comportant jusqu'à 20 tags personnalisés spécifiés pour ce forfait de base et renvoyés à l'application via la bibliothèque de facturation. Les offres d'abonnement pour ce forfait de base recevront également ces tags d'offre dans la bibliothèque de facturation.

object (OtherRegionsBasePlanConfig)

Informations tarifaires pour tout nouveau pays où Play pourra être lancé à l'avenir. S'il est omis, le forfait de base ne sera pas disponible automatiquement dans les nouveaux pays où Play sera disponible à l'avenir.

object (AutoRenewingBasePlanType)

Définissez la date à laquelle le forfait de base se renouvelle automatiquement à intervalle régulier.

object (PrepaidBasePlanType)

Indiquez quand le forfait de base n'est pas automatiquement renouvelé à la fin de la période de facturation.

{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}

string

Obligatoire. Durée 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.

string

Délai de grâce de l'abonnement, spécifié au format ISO 8601. Les valeurs acceptables sont 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.

enum (ResubscribeState)

Indique si les utilisateurs peuvent se réabonner à ce forfait de base dans les surfaces Google Play. Si aucune valeur n'est spécifiée, la valeur par défaut est REAB_STATE_ACTIVE.

enum (SubscriptionProrationMode)

Le mode de calcul au prorata du forfait de base détermine ce qui se passe lorsqu'un utilisateur passe d'un forfait de base à ce forfait. Si aucune valeur n'est spécifiée, la valeur par défaut est CHARGE_ON_NEXT_BILLING_DATE.

boolean

Indique si le forfait de base renouvelé est rétrocompatible.

Le forfait de base rétrocompatible est renvoyé par la méthode obsolète querySkuDetailsAsync() de la Bibliothèque Google Play Billing.

Un seul forfait de base renouvelé peut être marqué comme compatible avec les anciennes versions pour un abonnement donné.

string

ID de l'offre d'abonnement compatible avec les anciennes versions.

L'offre d'abonnement rétrocompatible est renvoyée par la méthode obsolète querySkuDetailsAsync() de la Bibliothèque Google Play Billing.

Une seule offre d'abonnement peut être marquée comme compatible avec les anciennes versions pour un forfait de base renouvelé donné.

Pour qu'aucune offre d'abonnement ne soit aussi compatible avec les anciennes versions, définissez ce champ sur une chaîne vide.

{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}

string

Obligatoire. Durée 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.

enum (TimeExtension)

Indique si les utilisateurs peuvent 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.

{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}

string

Obligatoire. Code régional auquel cette configuration s'applique, tel que défini par la norme ISO 3166-2 (par exemple, "US").

boolean

Indique si le forfait de base dans la région spécifiée est disponible pour les nouveaux abonnés. Les abonnements existants des abonnés existants ne seront pas annulés si cette valeur est définie sur "false". Si aucune valeur n'est spécifiée, la valeur par défaut est "false".

object (Money)

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.

{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}

object (Money)

Obligatoire. Prix en USD à utiliser pour tout nouveau pays où Play pourrait être lancé.

object (Money)

Obligatoire. Prix en euros à utiliser pour tout nouveau pays de lancement de Play.

boolean

Indique si le forfait de base est disponible pour les nouveaux abonnés dans de nouveaux pays où Play est disponible. Si aucune valeur n'est spécifiée, la valeur par défaut est "false".

{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}

string

Obligatoire. Langue de cette fiche, telle que définie par la norme BCP-47 (par exemple, "en-US").

string

Obligatoire. Titre de cet abonnement dans la langue de la fiche. Texte brut.

string

Liste des avantages présentés à l'utilisateur sur des plates-formes telles que le Play Store et dans les flux de restauration, dans la langue de cette fiche. Texte brut. Liste numérotée de quatre avantages au maximum.

string

Description de cet abonnement dans la langue de l'annonce. Ne doit pas dépasser 80 caractères. Texte brut.