- Risorsa: SubscriptionOffer
- Stato
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- RegionalSubscriptionOfferPhaseFreePriceOverride
- OtherRegionsSubscriptionOfferPhaseConfig
- OtherRegionsSubscriptionOfferPhasePrices
- OtherRegionsSubscriptionOfferPhaseFreePriceOverride
- SubscriptionOfferTargeting
- AcquisitionTargetingRule
- TargetingRuleScope
- TargetingRuleScopeThisSubscription
- TargetingRuleScopeAnySubscriptionInApp
- UpgradeTargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionsSubscriptionOfferConfig
- Metodi
Risorsa: SubscriptionOffer
Un'unica offerta temporanea
Rappresentazione JSON |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
Campi | |
---|---|
packageName |
Obbligatoria. Immutabile. Il nome del pacchetto dell'app a cui appartiene l'abbonamento padre. |
productId |
Obbligatoria. Immutabile. L'ID dell'abbonamento padre a cui appartiene questa offerta. |
basePlanId |
Obbligatoria. Immutabile. L'ID del piano base a cui l'offerta è un'estensione. |
offerId |
Obbligatoria. Immutabile. ID univoco di questa offerta di abbonamento. Deve essere univoco all'interno del piano base. |
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[] |
Obbligatoria. 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 |
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[] |
Obbligatoria. La configurazione di questa offerta specifica per regione. Deve contenere almeno una voce. |
otherRegionsConfig |
La configurazione per le nuove località che Google Play potrebbe lanciare in futuro. |
offerTags[] |
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 ( |
Campi | |
---|---|
recurrenceCount |
Obbligatoria. 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 |
Obbligatoria. La durata di una singola ricorrenza di questa fase. Specificato nel formato ISO 8601. |
regionalConfigs[] |
Obbligatoria. 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 |
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 |
Campi | |
---|---|
regionCode |
Obbligatoria. Immutabile. La regione a cui si applica la configurazione. |
Campo di unione price_override . La sostituzione di prezzo di questa fase. Obbligatoria. price_override può essere solo uno dei seguenti: |
|
price |
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 |
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 |
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 |
L'opzione Imposta per specificare l'offerta è senza costi. |
RegionalSubscriptionOfferPhaseFreePriceOverride
Questo tipo non contiene campi.
Rappresenta la configurazione della sostituzione di prezzo senza costi per una singola fase di un'offerta di abbonamento
OtherRegionsSubscriptionOfferPhaseConfig
Configurazione per le nuove località in cui Google Play può essere lanciato per una singola fase dell'offerta.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione price_override . La sostituzione di prezzo di questa fase. Obbligatoria. price_override può essere solo uno dei seguenti: |
|
otherRegionsPrices |
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 |
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 |
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 |
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 ( |
Campi | |
---|---|
usdPrice |
Obbligatoria. Prezzo in USD da utilizzare per le nuove località in cui Google Play potrebbe essere lanciato. |
eurPrice |
Obbligatoria. Prezzo in EUR da utilizzare per qualsiasi nuova località in cui potrebbe essere lanciato Play. |
OtherRegionsSubscriptionOfferPhaseFreePriceOverride
Questo tipo non contiene campi.
Rappresenta la configurazione senza costi dell'override del prezzo per 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 |
Campi | |
---|---|
Campo di unione rule . Lascia vuoto per indicare l'idoneità all'offerta stabilita dallo sviluppatore. rule può essere solo uno dei seguenti: |
|
acquisitionRule |
Regola di targeting dell'offerta per l'acquisizione di nuovi utenti. |
upgradeRule |
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 ( |
Campi | |
---|---|
scope |
Obbligatoria. 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 |
Campi | |
---|---|
Campo di unione
|
|
thisSubscription |
L'ambito della regola di targeting corrente è l'abbonamento in cui è definita l'offerta. |
anySubscriptionInApp |
L'ambito della regola di targeting corrente è qualsiasi abbonamento nell'app principale. |
specificSubscriptionInApp |
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 ( |
Campi | |
---|---|
oncePerUser |
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 |
Obbligatoria. L'ambito degli abbonamenti preso in considerazione da questa regola. Consente solo "questo abbonamento" e "abbonamento specifico nell'app". |
billingPeriodDuration |
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 |
Obbligatoria. Immutabile. Codice regione a cui si applica questa configurazione, come definito dallo standard ISO 3166-2, ad esempio "US". |
newSubscriberAvailability |
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 |
Se l'offerta di abbonamento in una nuova località Google Play potrebbe essere lanciata in futuro. Se non specificato, il valore predefinito è false. |
Metodi |
|
---|---|
|
Attiva un'offerta di abbonamento. |
|
Legge una o più offerte di abbonamento. |
|
Aggiorna un gruppo di offerte di abbonamento. |
|
Aggiorna un gruppo di stati delle offerte di abbonamento. |
|
Crea una nuova offerta di abbonamento. |
|
Disattiva un'offerta di abbonamento. |
|
Elimina un'offerta di abbonamento. |
|
Legge una singola offerta |
|
Elenca tutte le offerte sotto un determinato abbonamento. |
|
Consente di aggiornare un'offerta di abbonamento esistente. |