REST Resource: monetization.onetimeproducts.purchaseOptions.offers

Risorsa: OneTimeProductOffer

Una singola offerta per un prodotto a pagamento singolo.

Rappresentazione JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
Campi
packageName

string

Obbligatorio. Immutabile. Il nome del pacchetto dell'app a cui appartiene il prodotto principale.
productId

string

Obbligatorio. Immutabile. L'ID del prodotto principale a cui appartiene questa offerta.
purchaseOptionId

string

Obbligatorio. Immutabile. L'ID dell'opzione di acquisto a cui si estende questa offerta.
offerId

string

Obbligatorio. Immutabile. L'ID di questa offerta di prodotto. Deve essere univoco all'interno dell'opzione di acquisto. Deve iniziare con un numero o una lettera minuscola e può contenere solo lettere minuscole (a-z), numeri (0-9) e trattini (-). La lunghezza massima è di 63 caratteri.
state

enum (State)

Solo output. Lo stato attuale di questa offerta. Questo campo non può essere modificato aggiornando la risorsa. Utilizza invece gli endpoint dedicati.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Set di informazioni su prezzi e disponibilità a livello regionale per questa offerta. Non devono essere presenti voci duplicate con lo stesso regionCode.
offerTags[]

object (OfferTag)

(Facoltativo) Elenco di massimo 20 tag personalizzati specificati per questa offerta e restituiti all'app tramite la libreria di fatturazione.
regionsVersion

object (RegionsVersion)

Solo output. La versione della configurazione delle regioni utilizzata per generare l'offerta del prodotto a pagamento singolo.
Campo unione offer_type. Il tipo di offerta. Deve essere impostato esattamente un valore. offer_type può essere solo uno dei seguenti:
preOrderOffer

object (OneTimeProductPreOrderOffer)

Un'offerta di prenotazione.
discountedOffer

object (OneTimeProductDiscountedOffer)

Un'offerta scontata.

Stato

Lo stato attuale dell'offerta.

Enum
STATE_UNSPECIFIED Valore predefinito, non deve mai essere utilizzato.
DRAFT L'offerta non è mai stata disponibile per gli utenti.
ACTIVE L'offerta è disponibile per gli utenti, a condizione che vengano soddisfatte le condizioni.
CANCELLED Questo stato è specifico per le prenotazioni. L'offerta viene annullata e non è disponibile per gli utenti. Tutti gli ordini in attesa relativi a questa offerta sono stati annullati.
INACTIVE Questo stato è specifico per le offerte scontate. L'offerta non è più disponibile per gli utenti.

OneTimeProductPreOrderOffer

Configurazione specifica per le offerte di prenotazione.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
Campi
startTime

string (Timestamp format)

Obbligatorio. Ora in cui la prenotazione inizierà a essere disponibile.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Obbligatorio. L'ora in cui la prenotazione non sarà più disponibile.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
releaseTime

string (Timestamp format)

Obbligatorio. L'ora in cui il prodotto associato al pre-ordine verrà rilasciato e gli ordini di pre-ordine verranno eseguiti.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

Obbligatorio. Immutabile. Specifica in che modo le variazioni di prezzo influiscono sulle prenotazioni esistenti.

PreOrderPriceChangeBehavior

Specifica in che modo le variazioni di prezzo influiscono sulle prenotazioni esistenti.

Enum
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED Comportamento di variazione di prezzo non specificato. Non deve essere utilizzato.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST All'acquirente viene addebitato il prezzo minimo tra il prezzo iniziale al momento del pre-ordine e il prezzo dell'offerta finale alla data di uscita.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY L'acquirente riceve lo stesso prezzo della prenotazione, indipendentemente da eventuali modifiche ai prezzi che potrebbero essere state apportate dopo la prenotazione.

OneTimeProductDiscountedOffer

Configurazione specifica per le offerte scontate.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
Campi
startTime

string (Timestamp format)

L'ora in cui l'offerta inizierà a essere disponibile.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

L'ora in cui l'offerta non sarà più disponibile.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
redemptionLimit

string (int64 format)

(Facoltativo) Il numero di volte per cui è possibile utilizzare questa offerta. Se non è impostato o è impostato su 0, consente riscatti illimitati delle offerte. Altrimenti, deve essere un numero compreso tra 1 e 50 inclusi.

RegionalPricingAndAvailabilityConfig

Configurazione di prezzi e disponibilità a livello regionale per un'offerta di prodotti a pagamento singolo.

Rappresentazione JSON 
{
  "regionCode": string,
  "availability": enum (Availability),

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

string

Obbligatorio. Codice regione a cui si applica questa configurazione, come definito da ISO 3166-2, ad es. "US".
availability

enum (Availability)

Obbligatorio. La disponibilità per questa regione.
Campo unione price_override. L'override del prezzo di questa offerta. Deve essere impostato esattamente un valore. price_override può essere solo uno dei seguenti:
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

Verrà utilizzato il prezzo definito nell'opzione di acquisto per questa regione.
relativeDiscount

number

La frazione del prezzo dell'opzione di acquisto che l'utente paga per questa offerta. Ad esempio, se il prezzo dell'opzione di acquisto per questa regione è di 12 $, uno sconto del 50% corrisponderebbe a un prezzo di 6 $. 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 i dollari). Lo sconto relativo viene considerato non valido se il prezzo scontato risulta inferiore al prezzo minimo consentito in questa regione.
absoluteDiscount

object (Money)

Il valore assoluto dello sconto sottratto al prezzo dell'opzione di acquisto.

Deve essere compreso tra 0 e il prezzo dell'opzione di acquisto.

OneTimeProductOfferNoPriceOverrideOptions

Questo tipo non contiene campi.

Opzioni per le offerte di prodotti a pagamento singolo senza override del prezzo regionale.

Disponibilità

La disponibilità dell'offerta.

Enum
AVAILABILITY_UNSPECIFIED Disponibilità non specificata. Non deve essere utilizzato.
AVAILABLE L'offerta è disponibile per gli utenti.
NO_LONGER_AVAILABLE L'offerta non è più disponibile per gli utenti. Questo valore può essere utilizzato solo se la disponibilità è stata precedentemente impostata su DISPONIBILE.

Metodi

activate

 Attiva un'offerta di prodotto a pagamento singolo.

batchDelete

 Elimina una o più offerte di prodotti a pagamento singolo.

batchGet

 Legge una o più offerte di prodotti a pagamento singolo.

batchUpdate

 Crea o aggiorna una o più offerte di prodotti a pagamento singolo.

batchUpdateStates

 Aggiorna un batch di stati di offerte di prodotti a pagamento singolo.

cancel

 Annulla un'offerta di prodotto a pagamento singolo.

deactivate

 Disattiva un'offerta di un prodotto a pagamento singolo.

list

 Elenca tutte le offerte per una determinata app, prodotto o opzione di acquisto.