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 padre.
productId

string

obbligatorio. Immutabile. L'ID dell'abbonamento padre a cui appartiene questa offerta.
basePlanId

string

obbligatorio. Immutabile. L'ID del piano base a cui l'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 dell'offerta. Può essere modificato utilizzando le azioni di attivazione e disattivazione. 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, al massimo cinque. Gli utenti riceveranno sempre tutte queste fasi nell'ordine specificato. Non è possibile aggiungere, rimuovere o riordinare le fasi dopo la creazione iniziale.
targeting

object (SubscriptionOfferTargeting)

I requisiti che gli utenti devono soddisfare per essere idonei a usufruire di questa offerta. Rappresenta i requisiti che Google Play valuterà per decidere se un'offerta deve essere restituita. Gli sviluppatori potrebbero filtrare ulteriormente queste offerte.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

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

object (OtherRegionsSubscriptionOfferConfig)

La configurazione per le nuove località che Google Play potrebbe lanciare in futuro.
offerTags[]

object (OfferTag)

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

Stato

Lo stato attuale dell'offerta di abbonamento.

Enum
STATE_UNSPECIFIED Valore predefinito: non deve mai essere utilizzato.
DRAFT L'offerta di abbonamento non è disponibile per gli utenti e non è mai stata disponibile.
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 mantengono l'accesso.

SubscriptionOfferPhase

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 si ripete questa fase. 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 Google Play potrebbe essere lanciato.

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
  }
  // End of list of possible types for union field price_override.
}
Campi
regionCode

string

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

object (Money)

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

number

La frazione del prezzo del piano base ripartita proporzionalmente nella 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 di durata di 3 mesi corrisponde a un prezzo di 1,50 $. Lo sconto deve essere specificato sotto forma di frazione rigorosamente superiore a 0 e inferiore a 1. Il prezzo risultante verrà arrotondato all'unità fatturabile più vicina (ad es. centesimi per USD). Lo sconto relativo viene considerato non valido se il prezzo scontato è 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 è 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

L'opzione Imposta per specificare l'offerta è senza costi.

OtherRegionsSubscriptionOfferPhaseConfig

Configurazione per le nuove località in cui Google Play può 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
  }
  // End of list of possible types for union field price_override.
}
Campi
Campo di unione price_override. La sostituzione di prezzo di questa fase. obbligatorio. price_override può essere solo uno dei seguenti:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Il prezzo assoluto che l'utente paga per questa fase dell'offerta. Il prezzo non deve essere inferiore al prezzo minimo consentito per le nuove località in cui potrebbe essere disponibile Google Play.
relativeDiscount

number

La frazione del prezzo del piano base ripartita proporzionalmente nella 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 di durata di 3 mesi corrisponde a un prezzo di 1,50 $. Lo sconto deve essere specificato sotto forma di frazione rigorosamente superiore a 0 e inferiore a 1. Il prezzo risultante verrà arrotondato all'unità fatturabile più vicina (ad es. centesimi per USD). Lo sconto relativo viene considerato non valido se il prezzo scontato è inferiore al prezzo minimo consentito nelle nuove 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 è 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 potrebbe essere inferiore al prezzo minimo consentito per le nuove località in cui Google Play potrebbe lanciare.
free

object

L'opzione Imposta per specificare l'offerta è senza costi.

OtherRegionsSubscriptionOfferPhasePrices

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

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

object (Money)

obbligatorio. Prezzo in USD da utilizzare per le nuove località in cui Google Play potrebbe essere lanciato.
eurPrice

object (Money)

obbligatorio. Prezzo in EUR da utilizzare per qualsiasi nuova località in cui potrebbe essere lanciato Play.

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 di unione rule. Lascia vuoto per indicare l'idoneità all'offerta stabilita 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 dei piani esistenti degli utenti.

AcquisitionTargetingRule

Rappresenta una regola di targeting nel formato: L'utente non ha mai avuto {scope} prima d'ora.

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

object (TargetingRuleScope)

obbligatorio. L'ambito degli abbonamenti preso in considerazione da questa regola. Sono consentiti soltanto "questo abbonamento" e "qualsiasi abbonamento nell'app".

TargetingRuleScope

Definisce l'ambito degli abbonamenti a cui una regola di targeting può corrispondere alle offerte indirizzate agli utenti in base a un 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 di unione scope.

scope può essere solo uno dei seguenti:
thisSubscription

object (TargetingRuleScopeThisSubscription)

L'ambito della regola di targeting corrente è l'abbonamento in cui è definita l'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 è l'abbonamento con l'ID abbonamento 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 l'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 nel formato: l'utente al momento ha {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 offerta 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 preso in considerazione da questa regola. Consente solo "questo abbonamento" e "abbonamento specifico nell'app".
billingPeriodDuration

string

La durata specifica del periodo di fatturazione, specificata nel formato ISO 8601, a cui un utente deve essere attualmente abbonato per essere idoneo per questa regola. Se non specificato, vengono abbinati gli utenti abbonati a un 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 "US".
newSubscriberAvailability

boolean

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

OtherRegionsSubscriptionOfferConfig

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

Rappresentazione JSON 
{
  "otherRegionsNewSubscriberAvailability": boolean
}
Campi
otherRegionsNewSubscriberAvailability

boolean

Se l'offerta di abbonamento in una nuova località Google Play potrebbe essere lanciata 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

 Elimina un'offerta di abbonamento.

get

 Legge una singola offerta

list

 Elenca tutte le offerte sotto un determinato abbonamento.

patch

 Consente di aggiornare un'offerta di abbonamento esistente.