REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

Ce genre représente un objet SubscriptionPurchaseV2 dans le service androidpublisher.

string

Code ISO 3166-1 alpha-2 du pays/de la région de facturation de l'utilisateur au moment où l'abonnement a été accordé.

object (SubscriptionPurchaseLineItem)

Informations au niveau de l'article pour la souscription d'un abonnement. Les articles d'un même achat doivent être tous associés à AutoRenewingPlan ou à PrepaidPlan.

string (Timestamp format)

Heure à laquelle l'abonnement a été accordé. Non défini pour les abonnements en attente (l'abonnement a été créé, mais en attente de paiement lors de l'inscription).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

État actuel de l'abonnement.

string

ID de la dernière commande associée à l'achat de l'abonnement. Pour l'abonnement avec renouvellement automatique, il s'agit de l'ID de la commande d'inscription si celle-ci n'a pas encore été renouvelée ou de l'ID de la dernière commande périodique (commande réussie, en attente ou refusée). Pour un abonnement prépayé, il s'agit de l'ID de commande associé au jeton d'achat interrogé.

string

Jeton d'achat de l'ancien abonnement, si cet abonnement est l'un des éléments suivants: * Réinscription d'un abonnement résilié, mais non expiré * Mise à niveau ou rétrogradation d'un abonnement précédent * Passer d'un abonnement prépayé à un abonnement à renouvellement automatique * Passer d'un abonnement à renouvellement automatique à un abonnement prépayé. * Créditer un abonnement prépayé

object (PausedStateContext)

Contexte supplémentaire sur la suspension des abonnements. Présent uniquement si l'abonnement présente actuellement subscriptionState SUBSCRIPTION_STATE_PAUSED.

object (CanceledStateContext)

Contexte supplémentaire sur les abonnements résiliés. Uniquement présente si l'abonnement a actuellement un état d'abonnement : SUBSCRIPTION_STATE_CANCELED ou SUBSCRIPTION_STATE_EXPIRED.

object (TestPurchase)

Uniquement présente si cet abonnement est un achat test.

enum (AcknowledgementState)

État de confirmation de l'abonnement.

object (ExternalAccountIdentifiers)

Identifiant de compte utilisateur dans le service tiers.

object (SubscribeWithGoogleInfo)

Profil utilisateur associé aux achats effectués via "S'abonner avec Google".

{
  "autoResumeTime": string
}

string (Timestamp format)

Heure à laquelle l'abonnement sera automatiquement réactivé.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

L'abonnement a été résilié par l'utilisateur.

object (SystemInitiatedCancellation)

L'abonnement a été résilié par le système (en raison d'un problème de facturation, par exemple).

object (DeveloperInitiatedCancellation)

L'abonnement a été résilié par le développeur.

object (ReplacementCancellation)

L'abonnement a été remplacé par un nouvel abonnement.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

Informations fournies par l'utilisateur lorsqu'il suit le processus de résiliation d'abonnement (enquête sur le motif de résiliation).

string (Timestamp format)

Heure à laquelle l'abonnement a été résilié par l'utilisateur. Il est possible que l'utilisateur ait toujours accès à l'abonnement après cette période. Utilisez lineItems.expiry_time pour déterminer si un utilisateur y a toujours accès.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

Raison sélectionnée par l'utilisateur dans l'enquête d'annulation.

string

Défini uniquement pour CANCEL_SURVEY_REASON_OTHERS. Il s'agit de la réponse libre de l'utilisateur à l'enquête.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

Identifiant de compte utilisateur dans le service tiers. Uniquement présente si l'association de comptes a été effectuée lors du parcours d'achat d'un abonnement.

string

Version obscurcie de l'ID associée de manière unique au compte de l'utilisateur dans votre application. À présenter pour les achats suivants: * si l'association de comptes a été effectuée dans le cadre du parcours d'achat d'abonnement. * Il a été spécifié à l'aide de https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid lors de l'achat.

string

Version obscurcie de l'ID associée de manière unique au profil de l'utilisateur dans votre application. Présent uniquement s'il est spécifié avec https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid lors de l'achat.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

Identifiant du profil Google de l'utilisateur lors de l'achat de l'abonnement.

string

Nom de profil de l'utilisateur au moment de l'achat de l'abonnement.

string

Adresse e-mail de l'utilisateur lors de l'achat de l'abonnement.

string

Nom de l'utilisateur lors de l'achat de l'abonnement.

string

Nom de famille de l'utilisateur lors de l'achat de l'abonnement.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

ID du produit acheté (par exemple, "mensuel001").

string (Timestamp format)

Heure d'expiration ou d'expiration de l'abonnement, sauf si l'accès est prolongé (renouvellement, par exemple).

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

L'article est en cours de renouvellement automatique.

object (PrepaidPlan)

L'article est prépayé.

object (OfferDetails)

Détails de l'offre pour cet article.

object (DeferredItemReplacement)

Informations sur le remplacement d'article différé.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

Si l'abonnement est configuré pour se renouveler automatiquement (par exemple, l'utilisateur n'a pas résilié l'abonnement.

object (SubscriptionItemPriceChangeDetails)

Informations sur le dernier changement de prix de l'article depuis l'inscription à l'abonnement.

object (InstallmentPlan)

Engagement du plan de versement et informations sur l'État du plan de renouvellement automatique.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

Nouveau prix récurrent pour l'élément d'abonnement.

enum (PriceChangeMode)

Le mode de changement de prix définit les modifications apportées au prix de l'abonnement.

enum (PriceChangeState)

Indiquez que le changement de prix est en cours.

string (Timestamp format)

Date et heure du renouvellement à partir desquelles le changement de prix prendra effet pour l'utilisateur. Ce délai est susceptible d'être modifié (à une date ultérieure) en raison de cas où l'heure de renouvellement est décalée (par exemple, la suspension). Ce champ n'est renseigné que si le changement de prix n'a pas été pris en compte.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

Nombre total de paiements pour lesquels l'utilisateur est initialement engagé.

integer

Nombre total de paiements pour lesquels l'utilisateur sera engagé après chaque période d'engagement. Vide signifie que le plan de versement repassera à un abonnement à renouvellement automatique normal après l'engagement initial.

integer

Nombre total de paiements encore engagés à régler pour ce cycle de renouvellement.

object (PendingCancellation)

S'il est présent, ce plan de versement est en attente d'annulation. L'annulation ne se produira qu'une fois que l'utilisateur aura terminé tous les paiements engagés.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

S'il est présent, il s'agit du délai après lequel les achats de recharge de crédit sont autorisés pour le forfait prépayé. Ne sera pas disponible pour les forfaits prépayés arrivés à expiration.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

Derniers tags associés à l'offre. Il inclut les tags hérités du forfait de base.

string

ID du forfait de base. Disponible pour tous les forfaits de base et toutes les offres.

string

ID de l'offre. Uniquement disponible pour les offres à prix réduit.

{
  "productId": string
}

string

productId qui va remplacer le productId existant.