- Risorsa: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PlanTransitionDetails
- TransitionInfo
- TransitionState
- PriceStepUpConsentDetails
- ConsentState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- ItemReplacement
- ReplacementMode
- OfferPhase
- ProrationPeriodOfferPhase
- OriginalOfferPhaseType
- FreeTrialOfferPhase
- IntroductoryPriceOfferPhase
- BasePriceOfferPhase
- DeveloperTargetedOffer
- OutOfAppPurchaseContext
- OnHoldStateContext
- RenewalDeclinedContext
- InGracePeriodStateContext
- Metodi
Risorsa: SubscriptionPurchaseV2
Indica lo stato dell'acquisto di un abbonamento da parte di un utente.
| Rappresentazione JSON |
|---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
| Campi | |
|---|---|
kind |
Questo tipo rappresenta un oggetto SubscriptionPurchaseV2 nel servizio androidpublisher. |
regionCode |
Codice paese/regione di fatturazione ISO 3166-1 alpha-2 dell'utente al momento della concessione dell'abbonamento. |
lineItems[] |
Informazioni a livello di articolo per l'acquisto di un abbonamento. Gli articoli dello stesso acquisto devono essere tutti con AutoRenewingPlan o tutti con PrepaidPlan. |
startTime |
Data/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). Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
subscriptionState |
Lo stato attuale dell'abbonamento. |
linkedPurchaseToken |
Il token di acquisto del vecchio abbonamento se questo abbonamento è uno dei seguenti: * Nuova registrazione di un abbonamento annullato, ma non scaduto * Upgrade/downgrade da un abbonamento precedente. * Converti l'abbonamento prepagato in un abbonamento con rinnovo automatico. * Convertire un abbonamento con rinnovo automatico in un abbonamento prepagato. * Ricaricare un abbonamento prepagato. |
pausedStateContext |
Contesto aggiuntivo sugli abbonamenti in pausa. Presente solo se l'abbonamento ha attualmente subscriptionState SUBSCRIPTION_STATE_PAUSED. |
canceledStateContext |
Contesto aggiuntivo sugli abbonamenti annullati. Presente solo se l'abbonamento ha attualmente subscriptionState SUBSCRIPTION_STATE_CANCELED o SUBSCRIPTION_STATE_EXPIRED. |
testPurchase |
Presente solo se l'acquisto dell'abbonamento è un acquisto di prova. |
acknowledgementState |
Lo stato di conferma della sottoscrizione. |
externalAccountIdentifiers |
Identificatore dell'account utente nel servizio di terze parti. |
subscribeWithGoogleInfo |
Profilo utente associato agli acquisti effettuati con "Abbonati con Google". |
etag |
Tag entità che rappresenta lo stato attuale dell'abbonamento. Lo sviluppatore fornirà questo etag per le azioni relative all'abbonamento. Questo etag è sempre presente per gli abbonamenti con rinnovo automatico e prepagati. |
outOfAppPurchaseContext |
Contesto aggiuntivo per gli acquisti esterni all'app. Queste informazioni sono presenti solo per gli acquisti di riabbonamento (acquisti di abbonamenti effettuati dopo la scadenza dell'abbonamento precedente dello stesso prodotto) effettuati tramite il Centro abbonamenti di Google Play. Questo campo verrà rimosso dopo che avrai confermato l'abbonamento. |
onHoldStateContext |
Facoltativo. Contesto aggiuntivo sugli abbonamenti nello stato ON_HOLD. Presente solo se l'abbonamento ha attualmente subscriptionState SUBSCRIPTION_STATE_ON_HOLD. |
inGracePeriodStateContext |
Facoltativo. Contesto aggiuntivo sugli abbonamenti nello stato IN_GRACE_PERIOD. Presente solo se l'abbonamento ha attualmente subscriptionState SUBSCRIPTION_STATE_IN_GRACE_PERIOD. |
SubscriptionState
I potenziali stati in cui può trovarsi un abbonamento, ad esempio se è attivo o annullato. Gli articoli di un acquisto di abbonamento possono essere tutti piani con rinnovo automatico o piani prepagati.
| Enum | |
|---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
Stato della sottoscrizione non specificato. |
SUBSCRIPTION_STATE_PENDING |
L'abbonamento è stato creato, ma è in attesa di pagamento durante la registrazione. In questo stato, tutti gli articoli sono in attesa di pagamento. |
SUBSCRIPTION_STATE_ACTIVE |
L'abbonamento è attivo. - (1) Se l'abbonamento è un piano con rinnovo automatico, almeno un elemento è autoRenewEnabled e non è scaduto. - (2) Se l'abbonamento è un piano prepagato, almeno un articolo non è scaduto. |
SUBSCRIPTION_STATE_PAUSED |
L'abbonamento è stato messo in pausa. Lo stato è disponibile solo quando l'abbonamento è un piano con rinnovo automatico. In questo stato, tutti gli elementi sono in pausa. |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
L'abbonamento è nel periodo di tolleranza. Lo stato è disponibile solo quando l'abbonamento è un piano con rinnovo automatico. In questo stato, tutti gli articoli sono nel periodo di tolleranza. |
SUBSCRIPTION_STATE_ON_HOLD |
L'abbonamento è in pausa (sospeso). Lo stato è disponibile solo quando l'abbonamento è un piano con rinnovo automatico. In questo stato, tutti gli elementi sono in attesa. |
SUBSCRIPTION_STATE_CANCELED |
L'abbonamento è stato annullato, ma non è ancora scaduto. Lo stato è disponibile solo quando l'abbonamento è un piano con rinnovo automatico. Tutti gli elementi hanno autoRenewEnabled impostato su false. |
SUBSCRIPTION_STATE_EXPIRED |
L'abbonamento è scaduto. Tutti gli elementi hanno un valore expiryTime nel passato. |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
La transazione in attesa per l'abbonamento è stata annullata. Se questo acquisto in attesa riguardava un abbonamento esistente, utilizza linkedPurchaseToken per ottenere lo stato attuale dell'abbonamento. |
PausedStateContext
Informazioni specifiche per un abbonamento in stato di pausa.
| Rappresentazione JSON |
|---|
{ "autoResumeTime": string } |
| Campi | |
|---|---|
autoResumeTime |
L'ora in cui l'abbonamento verrà ripristinato automaticamente. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
CanceledStateContext
Informazioni specifiche per un abbonamento nello stato SUBSCRIPTION_STATE_CANCELED o SUBSCRIPTION_STATE_EXPIRED.
| Rappresentazione JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "userInitiatedCancellation": { object ( |
| Campi | |
|---|---|
| Il motivo per cui un abbonamento è stato annullato. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
userInitiatedCancellation |
L'abbonamento è stato annullato dall'utente. |
systemInitiatedCancellation |
L'abbonamento è stato annullato dal sistema, ad esempio a causa di un problema di fatturazione. |
developerInitiatedCancellation |
L'abbonamento è stato annullato dallo sviluppatore. |
replacementCancellation |
L'abbonamento è stato sostituito da un nuovo abbonamento. |
| Fine dei campi che si escludono a vicenda. | |
UserInitiatedCancellation
Informazioni specifiche sugli annullamenti avviati dagli utenti.
| Rappresentazione JSON |
|---|
{
"cancelSurveyResult": {
object ( |
| Campi | |
|---|---|
cancelSurveyResult |
Informazioni fornite dall'utente quando completa il flusso di annullamento dell'abbonamento (sondaggio sul motivo dell'annullamento). |
cancelTime |
L'ora in cui l'abbonamento è stato annullato dall'utente. L'utente potrebbe avere ancora accesso all'abbonamento dopo questo periodo. Utilizza lineItems.expiry_time per determinare se un utente ha ancora accesso. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
CancelSurveyResult
Risultato del sondaggio sull'annullamento quando l'abbonamento è stato annullato dall'utente.
| Rappresentazione JSON |
|---|
{
"reason": enum ( |
| Campi | |
|---|---|
reason |
Il motivo selezionato dall'utente nel sondaggio sull'annullamento. |
reasonUserInput |
Impostata solo per CANCEL_SURVEY_REASON_OTHERS. Questa è la risposta in formato libero dell'utente al sondaggio. |
CancelSurveyReason
Il motivo selezionato dall'utente nel sondaggio sull'annullamento.
| Enum | |
|---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
Motivo dell'annullamento del sondaggio non specificato. |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
Utilizzo insufficiente dell'abbonamento. |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
Problemi tecnici durante l'utilizzo dell'app. |
CANCEL_SURVEY_REASON_COST_RELATED |
Problemi relativi ai costi. |
CANCEL_SURVEY_REASON_FOUND_BETTER_APP |
L'utente ha trovato un'app migliore. |
CANCEL_SURVEY_REASON_OTHERS |
Altri motivi. |
SystemInitiatedCancellation
Questo tipo non ha campi.
Informazioni specifiche sugli annullamenti avviati dal sistema Google.
DeveloperInitiatedCancellation
Questo tipo non ha campi.
Informazioni specifiche sugli annullamenti avviati dagli sviluppatori.
ReplacementCancellation
Questo tipo non ha campi.
Informazioni specifiche sugli annullamenti causati dalla sostituzione dell'abbonamento.
TestPurchase
Questo tipo non ha campi.
Indica se l'acquisto dell'abbonamento è un acquisto di prova.
AcknowledgementState
I possibili stati di conferma di un abbonamento.
| Enum | |
|---|---|
ACKNOWLEDGEMENT_STATE_UNSPECIFIED |
Stato di conferma non specificato. |
ACKNOWLEDGEMENT_STATE_PENDING |
La sottoscrizione non è ancora stata confermata. |
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED |
La sottoscrizione viene confermata. |
ExternalAccountIdentifiers
Identificatore dell'account utente nel servizio di terze parti.
| Rappresentazione JSON |
|---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
| Campi | |
|---|---|
externalAccountId |
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. |
obfuscatedExternalAccountId |
Una versione offuscata dell'ID associato 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. |
obfuscatedExternalProfileId |
Una versione offuscata dell'ID associato 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. |
SubscribeWithGoogleInfo
Informazioni associate agli acquisti effettuati con "Abbonati con Google".
| Rappresentazione JSON |
|---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
| Campi | |
|---|---|
profileId |
L'ID profilo Google dell'utente al momento dell'acquisto dell'abbonamento. |
profileName |
Il nome del profilo dell'utente al momento dell'acquisto dell'abbonamento. |
emailAddress |
L'indirizzo email dell'utente al momento dell'acquisto dell'abbonamento. |
givenName |
Il nome dell'utente al momento dell'acquisto dell'abbonamento. |
familyName |
Il cognome dell'utente al momento dell'acquisto dell'abbonamento. |
SubscriptionPurchaseLineItem
Informazioni a livello di articolo per l'acquisto di un abbonamento.
| Rappresentazione JSON |
|---|
{ "productId": string, "expiryTime": string, "developerTargetedOffers": [ { object ( |
| Campi | |
|---|---|
productId |
L'ID prodotto acquistato (ad esempio "monthly001"). |
expiryTime |
L'ora in cui l'abbonamento è scaduto o scadrà, a meno che l'accesso non venga esteso (ad esempio, rinnovato). Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
developerTargetedOffers[] |
Facoltativo. Dettagli delle offerte destinate agli sviluppatori registrate per questo elemento pubblicitario. |
latestSuccessfulOrderId |
L'ID ordine dell'ultimo ordine andato a buon fine associato a questo articolo. Non presente se l'articolo non è ancora di proprietà dell'utente (ad esempio, l'articolo con cui viene sostituito l'articolo con sostituzione differita). |
| Il tipo di piano di abbonamento. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
autoRenewingPlan |
L'articolo si rinnova automaticamente. |
prepaidPlan |
L'articolo è prepagato. |
| Fine dei campi che si escludono a vicenda. | |
offerDetails |
I dettagli dell'offerta per questo articolo. |
| Il campo è presente quando un elemento ha una modifica differita. Può essere rimosso o sostituito. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
deferredItemReplacement |
Informazioni per la sostituzione differita degli articoli. |
deferredItemRemoval |
Informazioni per la rimozione differita degli elementi. |
| Fine dei campi che si escludono a vicenda. | |
signupPromotion |
Dettagli della promozione per questo articolo. Impostato solo se è stata applicata una promozione durante la registrazione. |
itemReplacement |
Dettagli dell'articolo da sostituire. Questo campo viene compilato solo se questo articolo ha sostituito un altro articolo in un abbonamento precedente ed è disponibile solo per 60 giorni dopo la data di acquisto. |
offerPhase |
Dettagli della fase dell'offerta corrente per questo articolo. |
AutoRenewingPlan
Informazioni relative a un piano con rinnovo automatico.
| Rappresentazione JSON |
|---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
| Campi | |
|---|---|
autoRenewEnabled |
Se l'abbonamento è attualmente impostato per il rinnovo automatico, ad esempio l'utente non ha annullato l'abbonamento |
recurringPrice |
Il prezzo ricorrente attuale del piano con rinnovo automatico. Tieni presente che il prezzo non tiene conto degli sconti e non include le tasse. Per i prezzi al netto delle imposte, chiama l'API |
priceChangeDetails |
Le informazioni sull'ultima variazione di prezzo dell'articolo dalla registrazione dell'abbonamento. |
installmentDetails |
L'impegno del piano rateale e le informazioni relative allo stato del piano con rinnovo automatico. |
planTransitionDetails |
Le informazioni sulla transizione del piano associato. Sarà presente solo se a questo piano è associato un piano di transizione e includerà solo i dettagli di transizione più recenti associati all'elemento. |
priceStepUpConsentDetails |
Le informazioni relative al consenso relativo all'aumento graduale del prezzo più recente. |
SubscriptionItemPriceChangeDetails
Informazioni relative alla variazione di prezzo di un articolo in abbonamento.
| Rappresentazione JSON |
|---|
{ "newPrice": { object ( |
| Campi | |
|---|---|
newPrice |
Nuovo prezzo ricorrente per l'articolo in abbonamento. |
priceChangeMode |
La modalità di variazione di prezzo specifica in che modo cambia il prezzo dell'articolo in abbonamento. |
priceChangeState |
Stato attuale della variazione di prezzo. |
expectedNewPriceChargeTime |
L'ora del rinnovo in cui la variazione di prezzo diventerà effettiva per l'utente. Questo valore è soggetto a modifiche (a un momento futuro) a causa di casi in cui l'ora di rinnovo cambia, ad esempio in caso di pausa. Questo campo viene compilato solo se la variazione di prezzo non è stata applicata. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
PriceChangeMode
La modalità della variazione di prezzo.
| Enum | |
|---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
Modalità di variazione di prezzo non specificata. Questo valore non deve mai essere impostato. |
PRICE_DECREASE |
Se il prezzo dell'abbonamento sta per diminuire. |
PRICE_INCREASE |
Se il prezzo dell'abbonamento aumenta e l'utente deve accettarlo. |
OPT_OUT_PRICE_INCREASE |
Se il prezzo dell'abbonamento aumenta con la modalità di disattivazione. |
PriceChangeState
Lo stato della variazione di prezzo.
| Enum | |
|---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
Stato della variazione di prezzo non specificato. Questo valore non deve essere utilizzato. |
OUTSTANDING |
In attesa che l'utente accetti la variazione di prezzo. |
CONFIRMED |
La variazione di prezzo è stata confermata per l'utente. |
APPLIED |
La variazione di prezzo viene applicata, ovvero all'utente viene addebitato il nuovo prezzo. |
CANCELED |
La variazione di prezzo è stata annullata. |
InstallmentPlan
Informazioni su un piano di pagamento rateale.
| Rappresentazione JSON |
|---|
{
"initialCommittedPaymentsCount": integer,
"subsequentCommittedPaymentsCount": integer,
"remainingCommittedPaymentsCount": integer,
"pendingCancellation": {
object ( |
| Campi | |
|---|---|
initialCommittedPaymentsCount |
Numero totale di pagamenti per i quali l'utente si impegna inizialmente. |
subsequentCommittedPaymentsCount |
Numero totale di pagamenti per i quali l'utente si impegnerà dopo ogni periodo di impegno. Se il campo è vuoto, il piano rateale verrà convertito in un normale abbonamento con rinnovo automatico dopo l'impegno iniziale. |
remainingCommittedPaymentsCount |
Numero totale di pagamenti impegnati rimanenti da pagare in questo ciclo di rinnovo. |
pendingCancellation |
Se presente, questo piano rateale è in attesa di essere annullato. L'annullamento avverrà solo dopo che l'utente avrà completato tutti i pagamenti previsti dall'impegno. |
PendingCancellation
Questo tipo non ha campi.
Indica se è presente un annullamento in attesa nel piano rateale virtuale. L'annullamento avverrà solo dopo che l'utente avrà completato tutti i pagamenti previsti dall'impegno.
PlanTransitionDetails
Informazioni relative a una transizione di piano.
| Rappresentazione JSON |
|---|
{
"productId": string,
"basePlanId": string,
"offerId": string,
"transitionInfo": {
object ( |
| Campi | |
|---|---|
productId |
[Obbligatorio] L'ID prodotto a cui verrà eseguita la transizione di questo piano (ad esempio, "monthly001"). |
basePlanId |
[Obbligatorio] L'ID del piano base a cui verrà eseguita la transizione di questo piano. |
offerId |
L'ID offerta. Presente solo per le offerte scontate. Questo valore viene impostato solo se il piano di destinazione non è un piano base. |
transitionInfo |
Informazioni aggiuntive sulla transizione del piano programmata. Sarà presente solo se è stata pianificata una transizione del piano. |
TransitionInfo
Informazioni relative a una transizione del piano programmata.
| Rappresentazione JSON |
|---|
{ "transitionState": enum ( |
| Campi | |
|---|---|
transitionState |
Solo output. [Obbligatorio] Lo stato attuale della transizione. |
price |
Il prezzo del piano base predefinito a cui verrà eseguita la transizione del piano. |
expectedTransitionTime |
L'ora prevista attuale in cui è possibile eseguire la transizione del piano. Questo valore è soggetto a modifiche (a una data futura) a causa di casi in cui l'ora del rinnovo cambia, ad esempio in caso di pausa e sospensione dell'account. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
TransitionState
I potenziali stati in cui può trovarsi una transizione.
| Enum | |
|---|---|
TRANSITION_STATE_UNSPECIFIED |
Stato di transizione non specificato. |
SCHEDULED |
La transizione è pianificata per iniziare in futuro. |
IN_PROGRESS |
Il processo di transizione è stato avviato e la notifica di transizione iniziale è stata inviata all'utente. |
COMPLETED |
La transizione è stata completata. |
CANCELED |
La transizione è stata annullata. |
PriceStepUpConsentDetails
Informazioni relative a un aumento di prezzo che richiede il consenso dell'utente.
| Rappresentazione JSON |
|---|
{ "state": enum ( |
| Campi | |
|---|---|
state |
Solo output. Lo stato del consenso all'aumento di prezzo. |
consentDeadlineTime |
La scadenza entro la quale l'utente deve fornire il consenso. Se il consenso non viene fornito entro questo termine, l'abbonamento verrà annullato. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
newPrice |
Il nuovo prezzo che richiede il consenso dell'utente. |
ConsentState
Lo stato del consenso all'aumento di prezzo.
| Enum | |
|---|---|
CONSENT_STATE_UNSPECIFIED |
Stato del consenso non specificato. |
PENDING |
L'utente non ha ancora fornito il consenso. |
CONFIRMED |
L'utente ha dato il consenso e il nuovo prezzo è in attesa di essere applicato. |
COMPLETED |
L'utente ha dato il consenso e il nuovo prezzo è entrato in vigore. |
PrepaidPlan
Informazioni relative a un piano prepagato.
| Rappresentazione JSON |
|---|
{ "allowExtendAfterTime": string } |
| Campi | |
|---|---|
allowExtendAfterTime |
Se presente, indica il momento dopo il quale sono consentiti gli acquisti di ricariche per il piano prepagato. Non sarà presente per i piani prepagati scaduti. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
OfferDetails
Informazioni sui dettagli dell'offerta relative a un elemento pubblicitario di acquisto.
| Rappresentazione JSON |
|---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
| Campi | |
|---|---|
offerTags[] |
I tag più recenti associati all'offerta. Include i tag ereditati dal piano base. |
basePlanId |
L'ID piano base. Presente per tutti i piani base e le offerte. |
offerId |
L'ID offerta. Presente solo per le offerte scontate. |
DeferredItemReplacement
Informazioni relative alla sostituzione differita degli articoli.
| Rappresentazione JSON |
|---|
{ "productId": string } |
| Campi | |
|---|---|
productId |
Il productId che sostituirà il productId esistente. |
DeferredItemRemoval
Questo tipo non ha campi.
Informazioni relative alla sostituzione differita degli articoli.
SignupPromotion
La promozione applicata a questo articolo al momento dell'acquisto.
| Rappresentazione JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "oneTimeCode": { object ( |
| Campi | |
|---|---|
| Il tipo di promozione applicata all'articolo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
oneTimeCode |
È stato applicato un codice monouso. |
vanityCode |
È stato applicato un codice vanity. |
| Fine dei campi che si escludono a vicenda. | |
OneTimeCode
Questo tipo non ha campi.
Un codice promozionale monouso.
VanityCode
Un codice promozionale predefinito multiuso.
| Rappresentazione JSON |
|---|
{ "promotionCode": string } |
| Campi | |
|---|---|
promotionCode |
Il codice promozionale. |
ItemReplacement
Dettagli su un elemento pubblicitario di abbonamento che viene sostituito.
| Rappresentazione JSON |
|---|
{
"productId": string,
"replacementMode": enum ( |
| Campi | |
|---|---|
productId |
L'ID prodotto dell'elemento pubblicitario dell'abbonamento che viene sostituito. |
replacementMode |
La modalità di sostituzione applicata durante l'acquisto. |
basePlanId |
L'ID piano base dell'elemento pubblicitario dell'abbonamento che viene sostituito. |
offerId |
L'ID offerta dell'elemento pubblicitario in abbonamento che viene sostituito, se applicabile. |
ReplacementMode
La modalità di sostituzione di un abbonamento.
| Enum | |
|---|---|
REPLACEMENT_MODE_UNSPECIFIED |
Modalità di sostituzione non specificata. |
WITH_TIME_PRORATION |
Il nuovo piano verrà calcolato in proporzione e accreditato dal piano precedente. |
CHARGE_PRORATED_PRICE |
All'utente verrà addebitato un prezzo proporzionale per il nuovo piano. |
WITHOUT_PRORATION |
Il nuovo piano sostituirà quello precedente senza ripartire il tempo. |
CHARGE_FULL_PRICE |
All'utente verrà addebitato l'intero prezzo del nuovo piano. |
DEFERRED |
Il piano precedente verrà annullato e il nuovo piano entrerà in vigore alla scadenza di quello precedente. |
KEEP_EXISTING |
Il piano rimarrà invariato con questa sostituzione. |
OfferPhase
Dettagli della fase dell'offerta.
| Rappresentazione JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "prorationPeriod": { object ( |
| Campi | |
|---|---|
| I dettagli della fase dell'offerta. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
prorationPeriod |
Impostato quando la fase dell'offerta è un periodo di ripartizione proporzionale. |
freeTrial |
Impostato quando la fase dell'offerta è una prova senza costi. |
introductoryPrice |
Impostato quando la fase dell'offerta è una fase di offerta con prezzo di lancio. |
basePrice |
Impostato quando la fase dell'offerta è una fase di determinazione del prezzo del piano base. |
| Fine dei campi che si escludono a vicenda. | |
ProrationPeriodOfferPhase
Dettagli sulla fase dell'offerta del periodo di ripartizione proporzionale.
| Rappresentazione JSON |
|---|
{
"originalOfferPhaseType": enum ( |
| Campi | |
|---|---|
originalOfferPhaseType |
Il tipo di fase dell'offerta originale prima del periodo di proroga. Impostato solo quando il periodo di ripartizione proporzionale viene aggiornato da una fase dell'offerta esistente. |
OriginalOfferPhaseType
La fase dell'offerta originale del pagamento dell'offerta, se il pagamento dell'offerta è un pagamento proporzionale.
| Enum | |
|---|---|
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED |
Tipo di fase dell'offerta originale non specificato. |
BASE |
L'abbonamento è nella fase di prezzo base (ad es. prezzo intero). |
INTRODUCTORY |
L'abbonamento è in una fase di prezzo di lancio. |
FREE_TRIAL |
L'abbonamento è in un periodo di prova senza costi. |
FreeTrialOfferPhase
Questo tipo non ha campi.
Dettagli sulla fase dell'offerta di prova senza costi.
IntroductoryPriceOfferPhase
Questo tipo non ha campi.
Dettagli sulla fase dell'offerta con prezzo di lancio.
BasePriceOfferPhase
Questo tipo non ha campi.
Dettagli sulla fase di offerta del prezzo base.
DeveloperTargetedOffer
Informazioni su un'offerta per sviluppatori per un elemento di abbonamento.
| Rappresentazione JSON |
|---|
{ "offerId": string, "activateTime": string } |
| Campi | |
|---|---|
offerId |
Facoltativo. L'ID offerta creato dallo sviluppatore scelto come target per l'abbonamento. |
activateTime |
Facoltativo. L'ora in cui è stato attivato il targeting dell'offerta. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
OutOfAppPurchaseContext
Informazioni specifiche su un acquisto esterno all'app.
| Rappresentazione JSON |
|---|
{
"expiredExternalAccountIdentifiers": {
object ( |
| Campi | |
|---|---|
expiredExternalAccountIdentifiers |
Identificatore dell'account utente dell'ultimo abbonamento scaduto per questo SKU. |
expiredPurchaseToken |
Il token di acquisto dell'ultimo abbonamento scaduto. Questo token di acquisto deve essere utilizzato solo per identificare l'utente se il collegamento tra purchaseToken e l'utente è memorizzato nel tuo database. Non può essere utilizzato per chiamare l'API Google Developer se sono trascorsi più di 60 giorni dalla scadenza. |
OnHoldStateContext
Contesto aggiuntivo sugli abbonamenti nello stato ON_HOLD.
| Rappresentazione JSON |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"renewalDeclined": {
object ( |
| Campi | |
|---|---|
| Il motivo per cui l'abbonamento è nello stato ON_HOLD. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
renewalDeclined |
Facoltativo. Il pagamento per il rinnovo è stato rifiutato. |
| Fine dei campi che si escludono a vicenda. | |
RenewalDeclinedContext
Contesto relativo allo scenario di rifiuto del rinnovo.
| Rappresentazione JSON |
|---|
{ "pendingOrderId": string } |
| Campi | |
|---|---|
pendingOrderId |
Obbligatorio. L'ID dell'ordine in attesa o non riuscito che causa lo stato. |
InGracePeriodStateContext
Contesto aggiuntivo sugli abbonamenti nello stato IN_GRACE_PERIOD.
| Rappresentazione JSON |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"renewalDeclined": {
object ( |
| Campi | |
|---|---|
| Il motivo per cui l'abbonamento è nello stato IN_GRACE_PERIOD. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi: | |
renewalDeclined |
Facoltativo. Il pagamento per il rinnovo è stato rifiutato. |
| Fine dei campi che si escludono a vicenda. | |
Metodi |
|
|---|---|
|
Attiva il targeting per un'offerta specifica. |
|
Annulla l'acquisto di un abbonamento per l'utente. |
|
Annullare una transizione di piano per un abbonamento. |
|
Disattiva il targeting per un'offerta specifica. |
|
Rimanda il rinnovo di un abbonamento. |
|
Recupera i metadati relativi a una sottoscrizione |
|
Revoca l'acquisto di un abbonamento per l'utente. |
|
Pianifica una transizione di piano per un abbonamento. |
Codici di errore
Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:
| Codice di errore | Motivo | Descrizione | Risoluzione |
|---|---|---|---|
400 / 410 |
subscriptionExpired |
L'abbonamento è scaduto e l'operazione richiesta non può essere eseguita. | Controlla la data di scadenza dell'abbonamento. Questa operazione non è consentita sugli abbonamenti scaduti. |
400 |
subscriptionInvalidArgument |
Nella richiesta di abbonamento è stato fornito un argomento non valido. | Consulta la documentazione dell'API e assicurati che tutti i campi obbligatori siano forniti e formattati correttamente. |
400 |
invalidPurchaseState |
L'acquisto non è in uno stato valido per eseguire l'operazione richiesta. Ad esempio, potresti tentare di confermare un acquisto già consumato o di annullare un abbonamento non attivo. | Controlla lo stato attuale della risorsa utilizzando l'API Get corrispondente prima di tentare l'operazione. Assicurati che la risorsa sia in uno stato appropriato per l'azione. |
400 |
invalidValue |
Nella richiesta è stato fornito un valore non valido. Questo errore viene spesso restituito per un token di acquisto non valido o non corretto. | Correggi il valore del campo non valido nel corpo della richiesta o nei parametri in base al riferimento API. |
400 |
prepaidSubscriptionNotSupported |
L'operazione richiesta non è supportata per gli abbonamenti prepagati. | Assicurati che l'operazione sia applicabile al tipo di abbonamento. Questo errore è specifico di metodi come Cancel. |
400 |
productNotOwnedByUser |
Il token di acquisto fornito è valido, ma l'utente non possiede attualmente il prodotto. Questo può accadere se l'acquisto è stato rimborsato, revocato o è scaduto prima della conferma. | Controlla lo stato attuale della risorsa utilizzando l'API Get corrispondente prima di tentare l'operazione. Assicurati che la risorsa sia in uno stato appropriato per l'azione. |
400 |
purchaseTokenMismatch |
Il token di acquisto fornito non corrisponde all'acquisto, al nome del pacchetto, all'ID abbonamento o all'ID prodotto. | Verifica che tutti i dettagli della richiesta siano corretti e corrispondano tra loro. |
400 |
required |
Nella richiesta manca un campo o un parametro obbligatorio. | Consulta la documentazione dell'API per assicurarti che siano inclusi tutti i campi e i parametri obbligatori. |
400 |
unsupportedIabType |
L'operazione non è supportata per il tipo di Fatturazione in-app specificato. | Assicurati che il metodo API sia compatibile con il tipo di elemento gestito. |
403 |
userInsufficientPermission |
L'utente non dispone di autorizzazioni sufficienti per eseguire l'operazione richiesta. | Assicurati che l'utente autenticato disponga delle autorizzazioni necessarie in Google Play Console. Per maggiori dettagli, consulta Utilizzo di un service account. |
404 |
notFound |
Impossibile trovare la risorsa richiesta. | Verifica che gli identificatori (ad es. token di acquisto, nome del pacchetto, ID prodotto, ID abbonamento) siano corretti. |
409 |
concurrentUpdate |
È stato effettuato un tentativo di aggiornare un oggetto che viene aggiornato contemporaneamente. | Riprova a inviare la richiesta con il backoff esponenziale. Evita modifiche simultanee alla stessa risorsa. |
410 |
purchaseTokenNoLongerValid |
Il token di acquisto non è valido in modo permanente perché l'account utente associato è stato eliminato o il record di acquisto non esiste più. | Interrompi l'utilizzo di questo token di acquisto. |
410 |
subscriptionNoLongerAvailable |
L'acquisto dell'abbonamento non è più disponibile per la query perché è scaduto da troppo tempo. | Questo errore indica che l'abbonamento è scaduto da più di 60 giorni. Non dovresti più eseguire query su questi abbonamenti. |
5xx |
Generic error |
Errore generico nel server Google Play. | Riprova a inviare la richiesta. Se il problema persiste, contatta il tuo account manager di Google Play o invia una richiesta di assistenza. Ti consigliamo di controllare la dashboard dello stato di Google Play per verificare la presenza di eventuali interruzioni note. |