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

Questo tipo rappresenta un oggetto SubscriptionPurchaseV2 nel servizio androidpublisher.

string

Codice paese/regione di fatturazione ISO 3166-1 alpha-2 dell'utente al momento della concessione dell'abbonamento.

object (SubscriptionPurchaseLineItem)

Informazioni a livello di articolo per un acquisto di abbonamento. Gli articoli nello stesso acquisto devono essere tutti con AutoRenewingPlan o tutti con PrepaidPlan.

string (Timestamp format)

Ora in cui è stato concesso l'abbonamento. Non impostato per gli abbonamenti in attesa (l'abbonamento è stato creato, ma è in attesa di pagamento durante la registrazione).

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

Lo stato attuale dell'abbonamento.

string

L'ID dell'ordine più recente associato all'acquisto dell'abbonamento. Per l'abbonamento con rinnovo automatico, si tratta dell'ID ordine dell'ordine di registrazione se non è ancora stato rinnovato o dell'ultimo ID ordine ricorrente (ordine riuscito, in attesa o rifiutato). Per l'abbonamento prepagato, si tratta dell'ID ordine associato al token di acquisto sottoposto a query.

string

Il token di acquisto dell'abbonamento precedente se si tratta di uno dei seguenti: * Registrazione di un abbonamento annullato, ma non scaduto * Upgrade/downgrade da un abbonamento precedente. * Passare da un abbonamento prepagato a un abbonamento con rinnovo automatico. * Passare da un abbonamento con rinnovo automatico a un abbonamento prepagato. * Ricaricare un abbonamento prepagato.

object (PausedStateContext)

Contesto aggiuntivo sugli abbonamenti in pausa. Presente solo se l'abbonamento ha attualmente subscriptionState SUBSCRIPTION_STATE_PAUSED.

object (CanceledStateContext)

Contesto aggiuntivo sugli abbonamenti annullati. Presente solo se l'abbonamento ha attualmente lo stato subscriptionState SUBSCRIPTION_STATE_CANCELED o SUBSCRIPTION_STATE_EXPIRED.

object (TestPurchase)

Presente solo se l'acquisto dell'abbonamento è un acquisto di prova.

enum (AcknowledgementState)

Lo stato di conferma dell'abbonamento.

object (ExternalAccountIdentifiers)

Identificatore dell'account utente nel servizio di terze parti.

object (SubscribeWithGoogleInfo)

Profilo utente associato agli acquisti effettuati con "Abbonati con Google".

{
  "autoResumeTime": string
}

string (Timestamp format)

Data e ora in cui l'abbonamento verrà ripreso automaticamente.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "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'abbonamento è stato annullato dall'utente.

object (SystemInitiatedCancellation)

L'abbonamento è stato annullato dal sistema, ad esempio a causa di un problema di fatturazione.

object (DeveloperInitiatedCancellation)

L'abbonamento è stato annullato dallo sviluppatore.

object (ReplacementCancellation)

L'abbonamento è stato sostituito da un nuovo abbonamento.

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

object (CancelSurveyResult)

Informazioni fornite dall'utente quando completa il flusso di annullamento dell'abbonamento (sondaggio sul motivo dell'annullamento).

string (Timestamp format)

La data e l'ora in cui l'abbonamento è stato annullato dall'utente. L'utente potrebbe comunque avere accesso all'abbonamento dopo questa data. Utilizza lineItems.expiry_time per determinare se un utente ha ancora accesso.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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

enum (CancelSurveyReason)

Il motivo selezionato dall'utente nel sondaggio sull'annullamento.

string

Impostato solo per CANCEL_SURVEY_REASON_OTHERS. Si tratta della risposta libera dell'utente al sondaggio.

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

string

Identificatore dell'account utente nel servizio di terze parti. Presente solo se il collegamento dell'account è avvenuto nell'ambito del flusso di acquisto dell'abbonamento.

string

Una versione offuscata dell'ID associata in modo univoco all'account dell'utente nella tua app. Presente per i seguenti acquisti: * Se il collegamento dell'account è avvenuto nell'ambito del flusso di acquisto dell'abbonamento. * È stato specificato utilizzando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid al momento dell'acquisto.

string

Una versione offuscata dell'ID associata in modo univoco al profilo dell'utente nella tua app. È presente solo se specificato utilizzando https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid al momento dell'acquisto.

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

string

L'ID profilo Google dell'utente al momento dell'acquisto dell'abbonamento.

string

Il nome del profilo dell'utente al momento dell'acquisto dell'abbonamento.

string

L'indirizzo email dell'utente al momento dell'acquisto dell'abbonamento.

string

Il nome dell'utente al momento dell'acquisto dell'abbonamento.

string

Il cognome dell'utente al momento dell'acquisto dell'abbonamento.

{
  "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.
  "signupPromotion": {
    object (SignupPromotion)
  }
}

string

L'ID prodotto acquistato (ad es. "monthly001").

string (Timestamp format)

Data e ora in cui l'abbonamento è scaduto o scadrà, a meno che l'accesso non venga esteso (ad es. rinnovato).

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

L'articolo si rinnova automaticamente.

object (PrepaidPlan)

L'articolo è prepagato.

object (OfferDetails)

I dettagli dell'offerta per questo articolo.

object (DeferredItemReplacement)

Informazioni per la sostituzione di articoli differita.

object (SignupPromotion)

Dettagli della promozione relativi a questo articolo. Impostato solo se è stata applicata una promozione durante la registrazione.

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

boolean

Se l'abbonamento è attualmente impostato sul rinnovo automatico, ad esempio se l'utente non lo ha annullato

object (SubscriptionItemPriceChangeDetails)

Le informazioni sull'ultima variazione di prezzo dell'articolo dall'iscrizione all'abbonamento.

object (InstallmentPlan)

L'impegno relativo al piano di rateizzazione e le informazioni relative allo stato del piano con rinnovo automatico.

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

object (Money)

Nuovo prezzo ricorrente per l'articolo dell'abbonamento.

enum (PriceChangeMode)

La modalità di variazione del prezzo specifica in che modo cambia il prezzo dell'articolo dell'abbonamento.

enum (PriceChangeState)

Indica lo stato attuale della variazione di prezzo.

string (Timestamp format)

La data di rinnovo in cui la variazione di prezzo entrerà in vigore per l'utente. Questo valore può cambiare(in un momento futuro) a causa di casi in cui la data di rinnovo cambia, ad esempio in caso di pausa. Questo campo viene compilato solo se la modifica del prezzo non è stata applicata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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

integer

Numero totale di pagamenti per i quali l'utente si è inizialmente impegnato.

integer

Numero totale di pagamenti per i quali l'utente si impegna dopo ogni periodo di impegno. Se il campo è vuoto, dopo il periodo di impegno iniziale il piano di rateizzazione tornerà a un normale abbonamento con rinnovo automatico.

integer

Numero totale di pagamenti impegnati rimanenti da pagare in questo ciclo di rinnovo.

object (PendingCancellation)

Se presente, questo piano di rateizzazione è in attesa di annullamento. L'annullamento verrà eseguito solo dopo che l'utente avrà completato tutti i pagamenti previsti.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Se presente, si tratta del momento dopo il quale sono consentiti gli acquisti di ricariche per il piano prepagato. Non sarà presente per i piani prepagati scaduti.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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

string

I tag di offerta più recenti associati all'offerta. Sono inclusi i tag ereditati dal piano base.

string

L'ID piano base. Presente per tutti i piani base e le offerte.

string

L'ID offerta. Presente solo per le offerte scontate.

{
  "productId": string
}

string

Il nuovo productId sostituirà quello esistente.

{

  // Union field promotion_type can be only one of the following:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of list of possible types for union field promotion_type.
}

object (OneTimeCode)

È stato applicato un codice una tantum.

object (VanityCode)

È stato applicato un codice vanity.

{
  "promotionCode": string
}

string

Il codice promozionale.