REST Resource: monetization.subscriptions.basePlans.offers

Risorsa: SubscriptionOffer

Un'unica offerta temporanea

Rappresentazione JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}
Campi
packageName

string

Obbligatorio. Immutabile. Il nome del pacchetto dell'app a cui appartiene l'abbonamento principale.
productId

string

Obbligatorio. Immutabile. L'ID dell'abbonamento principale a cui appartiene questa offerta.
basePlanId

string

Obbligatorio. Immutabile. L'ID del piano base a cui questa offerta è un'estensione.
offerId

string

Obbligatorio. Immutabile. ID univoco di questa offerta di abbonamento. Deve essere univoco all'interno del piano base.
state

enum (State)

Solo output. Lo stato attuale di questa offerta. Può essere modificato utilizzando le azioni Attiva e Disattiva. Nota: lo stato del piano base prevale su questo stato, pertanto un'offerta attiva potrebbe non essere disponibile se il piano base non è attivo.
phases[]

object (SubscriptionOfferPhase)

Obbligatorio. Le fasi di questa offerta di abbonamento. Deve contenere almeno una voce e può contenere al massimo cinque. Gli utenti riceveranno sempre tutte queste fasi nell'ordine specificato. Le fasi non possono essere aggiunte, rimosse o riordinate dopo la creazione iniziale.
targeting

object (SubscriptionOfferTargeting)

I requisiti che gli utenti devono soddisfare per essere idonei per questa offerta. Rappresenta i requisiti che Google Play valuterà per decidere se restituire un'offerta. Gli sviluppatori possono filtrare ulteriormente queste offerte in autonomia.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

Obbligatorio. La configurazione specifica per regione di questa offerta. Deve contenere almeno una voce.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

La configurazione per eventuali nuove località in cui Google Play potrebbe essere lanciata in futuro.
offerTags[]

object (OfferTag)

Elenco di massimo 20 tag personalizzati specificati per questa offerta e restituiti all'app tramite la Libreria Fatturazione.

Stato

Stato attuale dell'offerta di abbonamento.

Enum
STATE_UNSPECIFIED Valore predefinito, non deve mai essere utilizzato.
DRAFT L'offerta di abbonamento non è disponibile e non è mai stata disponibile per gli utenti.
ACTIVE L'offerta di abbonamento è disponibile per gli utenti nuovi ed esistenti.
INACTIVE L'offerta di abbonamento non è disponibile per i nuovi utenti. Gli utenti esistenti manterranno l'accesso.

SubscriptionOfferPhase

Una singola fase di un'offerta di abbonamento.

Rappresentazione JSON 
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
Campi
recurrenceCount

integer

Obbligatorio. Il numero di volte in cui questa fase si ripete. Se questa fase dell'offerta non è senza costi, ogni ricorrenza addebita all'utente il prezzo di questa fase dell'offerta.
duration

string

Obbligatorio. La durata di una singola ricorrenza di questa fase. Specificato nel formato ISO 8601.
regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

Obbligatorio. La configurazione specifica per regione di questa fase dell'offerta. Questo elenco deve contenere esattamente una voce per ogni regione per la quale l'offerta di abbonamento ha una configurazione regionale.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

Informazioni sui prezzi per eventuali nuove località in cui potrebbe essere lanciato Google Play.

RegionalSubscriptionOfferPhaseConfig

Configurazione per una singola fase di un'offerta di abbonamento in un'unica regione.

Rappresentazione JSON 
{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Campi
regionCode

string

Obbligatorio. Immutabile. La regione a cui si applica questa configurazione.
Campo unione price_override. La variazione di prezzo di questa fase. Obbligatorio. price_override può essere solo uno dei seguenti:
price

object (Money)

Il prezzo assoluto pagato dall'utente per questa fase dell'offerta. Il prezzo non deve essere inferiore al prezzo minimo consentito per questa regione.
relativeDiscount

number

Frazione del prezzo del piano base ripartita proporzionalmente per la durata della fase che l'utente paga per questa fase dell'offerta. Ad esempio, se il prezzo del piano base per questa regione è di 12 $per un periodo di 1 anno, uno sconto del 50% per una fase della durata di 3 mesi corrisponde a un prezzo di 1,50 $. Lo sconto deve essere specificato come frazione strettamente maggiore di 0 e strettamente minore di 1. Il prezzo risultante verrà arrotondato all'unità fatturabile più vicina (ad es. centesimi per USD). Lo sconto relativo è considerato non valido se il prezzo scontato risulta inferiore al prezzo minimo consentito in questa regione.
absoluteDiscount

object (Money)

L'importo assoluto sottratto dal prezzo del piano base ripartito proporzionalmente per la durata della fase che l'utente paga per questa fase dell'offerta. Ad esempio, se il prezzo del piano base per questa regione è di 12 $per un periodo di 1 anno, uno sconto assoluto di 1 $per una fase della durata di 3 mesi corrisponde a un prezzo di 2 $. Il prezzo risultante non può essere inferiore al prezzo minimo consentito per questa regione.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Imposta per specificare che questa offerta è senza costi.

RegionalSubscriptionOfferPhaseFreePriceOverride

Questo tipo non contiene campi.

Rappresenta la configurazione dell'override di prezzo senza costi per una singola fase di un'offerta di abbonamento

OtherRegionsSubscriptionOfferPhaseConfig

Configurazione per eventuali nuove località in cui Google Play potrebbe essere lanciato per una singola fase dell'offerta.

Rappresentazione JSON 
{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Campi
Campo unione price_override. La variazione di prezzo di questa fase. Obbligatorio. price_override può essere solo uno dei seguenti:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Il prezzo assoluto pagato dall'utente per questa fase dell'offerta. Il prezzo non deve essere inferiore al prezzo minimo consentito per qualsiasi nuova località in cui può essere lanciato Google Play.
relativeDiscount

number

Frazione del prezzo del piano base ripartita proporzionalmente per la durata della fase che l'utente paga per questa fase dell'offerta. Ad esempio, se il prezzo del piano base per questa regione è di 12 $per un periodo di 1 anno, uno sconto del 50% per una fase della durata di 3 mesi corrisponde a un prezzo di 1,50 $. Lo sconto deve essere specificato come frazione strettamente maggiore di 0 e strettamente minore di 1. Il prezzo risultante verrà arrotondato all'unità fatturabile più vicina (ad es. centesimi per USD). Lo sconto relativo è considerato non valido se il prezzo scontato risulta inferiore al prezzo minimo consentito in qualsiasi nuova località in cui Google Play potrebbe essere lanciato.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

L'importo assoluto sottratto dal prezzo del piano base ripartito proporzionalmente per la durata della fase che l'utente paga per questa fase dell'offerta. Ad esempio, se il prezzo del piano base per questa regione è di 12 $per un periodo di 1 anno, uno sconto assoluto di 1 $per una fase della durata di 3 mesi corrisponde a un prezzo di 2 $. Il prezzo risultante non può essere inferiore al prezzo minimo consentito per qualsiasi nuova località in cui può essere lanciato Google Play.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Imposta per specificare che questa offerta è senza costi.

OtherRegionsSubscriptionOfferPhasePrices

Informazioni sui prezzi per eventuali nuove località in cui potrebbe essere lanciato Google Play.

Rappresentazione JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}
Campi
usdPrice

object (Money)

Obbligatorio. Il prezzo in USD da utilizzare per eventuali nuove località in cui potrebbe essere lanciato Google Play.
eurPrice

object (Money)

Obbligatorio. Prezzo in euro da utilizzare per eventuali nuove località in cui potrebbe essere lanciato Google Play.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

Questo tipo non contiene campi.

Rappresenta la configurazione dell'override di prezzo senza costi per tutte le nuove località che Google Play potrebbe lanciare per una singola fase dell'offerta.

SubscriptionOfferTargeting

Definisce la regola che un utente deve soddisfare per ricevere questa offerta.

Rappresentazione JSON 
{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}
Campi
Campo unione rule. Lascia vuoto per stabilire l'idoneità dell'offerta determinata dallo sviluppatore. rule può essere solo uno dei seguenti:
acquisitionRule

object (AcquisitionTargetingRule)

Regola di targeting dell'offerta per l'acquisizione di nuovi utenti.
upgradeRule

object (UpgradeTargetingRule)

Regola di targeting dell'offerta per l'upgrade degli utenti i piani esistenti.

AcquisitionTargetingRule

Rappresenta una regola di targeting del modulo: l'utente non ha mai avuto {scope} prima.

Rappresentazione JSON 
{
  "scope": {
    object (TargetingRuleScope)
  }
}
Campi
scope

object (TargetingRuleScope)

Obbligatorio. L'ambito degli abbonamenti considerati da questa regola. Consente solo "questo abbonamento" e "qualsiasi abbonamento nell'app".

TargetingRuleScope

Definisce l'ambito degli abbonamenti che una regola di targeting può abbinare per scegliere come target le offerte per gli utenti in base al diritto passato o attuale.

Rappresentazione JSON 
{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
Campi

Campo unione scope.

scope può essere solo uno dei seguenti:
thisSubscription

object (TargetingRuleScopeThisSubscription)

L'ambito dell'attuale regola di targeting è l'abbonamento in cui è definita questa offerta.
anySubscriptionInApp

object (TargetingRuleScopeAnySubscriptionInApp)

L'ambito della regola di targeting corrente è qualsiasi abbonamento nell'app principale.
specificSubscriptionInApp

string

L'ambito della regola di targeting corrente è la sottoscrizione con l'ID sottoscrizione specificato. Deve essere un abbonamento all'interno della stessa app principale.

TargetingRuleScopeThisSubscription

Questo tipo non contiene campi.

Rappresenta l'ambito della regola di targeting corrispondente agli abbonamenti in cui è definita questa offerta.

TargetingRuleScopeAnySubscriptionInApp

Questo tipo non contiene campi.

Rappresenta l'ambito della regola di targeting corrispondente a qualsiasi abbonamento nell'app principale.

UpgradeTargetingRule

Rappresenta una regola di targeting del modulo: l'utente ha attualmente {scope} [con periodo di fatturazione {billing_period}].

Rappresentazione JSON 
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
Campi
oncePerUser

boolean

Limita questa offerta a una sola volta per utente. Se viene impostato su true, un utente non potrà più usufruire di questa offerta se si è abbonato all'offerta.
scope

object (TargetingRuleScope)

Obbligatorio. L'ambito degli abbonamenti considerati da questa regola. Consente solo "questo abbonamento" e "abbonamento specifico nell'app".
billingPeriodDuration

string

La durata del periodo di fatturazione, specificata nel formato ISO 8601, a cui un utente deve essere attualmente abbonato per poter usufruire di questa regola. Se non specificato, vengono associati gli utenti abbonati a qualsiasi periodo di fatturazione.

RegionalSubscriptionOfferConfig

Configurazione di un'offerta di abbonamento in una singola regione.

Rappresentazione JSON 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
Campi
regionCode

string

Obbligatorio. Immutabile. Codice regione a cui si applica questa configurazione, come definito dallo standard ISO 3166-2, ad esempio "Stati Uniti".
newSubscriberAvailability

boolean

Indica se l'offerta di abbonamento nella regione specificata è disponibile per i nuovi abbonati. Se questo valore viene impostato su false, gli abbonati esistenti non verranno annullati. Se non specificato, il valore predefinito è false.

OtherRegionsSubscriptionOfferConfig

Configurazione per eventuali nuove località in cui Google Play potrebbe essere lanciato in un'offerta di abbonamento specifica.

Rappresentazione JSON 
{
  "otherRegionsNewSubscriberAvailability": boolean
}
Campi
otherRegionsNewSubscriberAvailability

boolean

Se l'offerta di abbonamento in nuove località può essere lanciata su Google Play in futuro. Se non specificato, il valore predefinito è false.

Metodi

activate

 Attiva un'offerta di abbonamento.

batchGet

 Legge una o più offerte di abbonamento.

batchUpdate

 Aggiorna un gruppo di offerte di abbonamento.

batchUpdateStates

 Aggiorna un gruppo di stati delle offerte di abbonamento.

create

 Crea una nuova offerta di abbonamento.

deactivate

 Disattiva un'offerta di abbonamento.

delete

 Consente di eliminare un'offerta di abbonamento.

get

 Legge una singola offerta

list

 Elenca tutte le offerte di un determinato abbonamento.

patch

 Aggiorna un'offerta di abbonamento esistente.