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

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

object (SubscriptionPurchaseLineItem)

Informazioni a livello di articolo per l'acquisto di un abbonamento. Gli articoli dello stesso acquisto devono essere tutti con AutoRenewingPlan o tutti con PrepagPlan.

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" RFC3339 UTC, con risoluzione in nanosecondi 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'ultimo ordine associato all'acquisto dell'abbonamento. Per l'abbonamento con rinnovo automatico, si tratta dell'ID dell'ordine di registrazione (se non è stato ancora rinnovato) o dell'ID dell'ultimo ordine ricorrente (ordine riuscito, in attesa o rifiutato). Per l'abbonamento prepagato, si tratta dell'ID ordine associato al token di acquisto oggetto della query.

string

Il token di acquisto dell'abbonamento precedente, se questo è uno dei seguenti: * Nuova registrazione di un abbonamento annullato ma non scaduto * Upgrade/downgrade da un abbonamento precedente. * Passa da un abbonamento prepagato a un abbonamento con rinnovo automatico. * Passa 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 al momento l'abbonamento ha il valore subscriptionState SUBSCRIPTION_STATE_PAUSED.

object (CanceledStateContext)

Contesto aggiuntivo sugli abbonamenti annullati. Presente solo se al momento l'abbonamento ha 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 accettazione dell'abbonamento.

object (ExternalAccountIdentifiers)

Identificatore dell'account utente nel servizio di terze parti.

object (SubscribeWithGoogleInfo)

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

{
  "autoResumeTime": string
}

string (Timestamp format)

Ora in cui l'abbonamento verrà ripristinato automaticamente.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi 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 sui motivi dell'annullamento).

string (Timestamp format)

L'ora in cui l'abbonamento è stato annullato dall'utente. Trascorso questo periodo, l'utente potrebbe avere ancora accesso all'abbonamento. Utilizza lineItems.expiry_time per determinare se un utente ha ancora accesso.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi 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 per cui l'utente ha selezionato nel sondaggio per l'annullamento.

string

Impostato solo per CANCEL_SURVEY_REASON_OTHERS. Si tratta della risposta in formato libero 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 tramite 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 del 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 nome della famiglia 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.
}

string

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

string (Timestamp format)

Il momento in cui l'abbonamento è scaduto o scadrà a meno che l'accesso non venga esteso (ad esempio, il rinnovo).

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

object (AutoRenewingPlan)

L'elemento si rinnova automaticamente.

object (PrepaidPlan)

L'articolo è prepagato.

object (OfferDetails)

I dettagli dell'offerta per questo articolo.

object (DeferredItemReplacement)

Informazioni per la sostituzione degli articoli differita.

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

boolean

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

object (SubscriptionItemPriceChangeDetails)

Le informazioni dell'ultima variazione di prezzo dell'articolo dalla registrazione dell'abbonamento.

object (InstallmentPlan)

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

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

object (Money)

Nuovo prezzo ricorrente per l'abbonamento.

enum (PriceChangeMode)

La modalità di variazione di prezzo specifica come cambia il prezzo dell'abbonamento.

enum (PriceChangeState)

Indica dove si trova attualmente la variazione di prezzo.

string (Timestamp format)

La data di rinnovo in cui la variazione di prezzo entrerà in vigore per l'utente. Questo è soggetto a variazioni(in futuro) a causa dei casi in cui l'orario di rinnovo cambia, ad esempio la pausa. Questo campo viene compilato solo se la variazione di prezzo non è stata applicata.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi 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 impegnerà dopo ogni periodo di impegno. Vuoto significa che il piano di rateizzazione torna a un normale abbonamento con rinnovo automatico dopo l'impegno iniziale.

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 avverrà solo dopo che l'utente ha completato tutti i pagamenti impegnati.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Se presente, è il periodo di tempo dopo il quale sono consentiti gli acquisti di ricarica per il piano prepagato. Non sarà presente per i piani prepagati scaduti.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi 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 più recenti dell'offerta associati all'offerta. Include i tag ereditati dal piano base.

string

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

string

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

{
  "productId": string
}

string

Il valore productId sostituirà il productId esistente.