REST Resource: offerobject

Risorsa: OfferObject

Rappresentazione JSON
{
  "kind": string,
  "classReference": {
    object (OfferClass)
  },
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  }
}
Campi
kind
(deprecated)

string

Identifica il tipo di risorsa. Valore: la stringa fissa "walletobjects#offerObject".

classReference

object (OfferClass)

Una copia dei campi ereditati della classe principale. Questi campi vengono recuperati durante una richiesta GET.

id

string

obbligatorio. L'identificatore univoco di un oggetto. Questo ID deve essere univoco in tutti gli oggetti di un emittente. Questo valore deve essere nel formato issuer ID.identifier, dove la prima è rilasciata da Google e la seconda è scelta da te. L'identificatore univoco deve includere solo caratteri alfanumerici, ".", "_" o "-".

classId

string

obbligatorio. La classe associata all'oggetto. La classe deve essere dello stesso tipo di questo oggetto, deve già esistere e deve essere approvata.

Gli ID classe devono essere nel formato issuer ID.identifier, dove la prima è rilasciata da Google e la seconda è scelta da te.

version
(deprecated)

string (int64 format)

Deprecata

state

enum (State)

obbligatorio. Lo stato dell'oggetto. Questo campo viene utilizzato per determinare in che modo un oggetto viene visualizzato nell'app. Ad esempio, un oggetto inactive viene spostato nella sezione "Tessere scadute".

barcode

object (Barcode)

Il tipo e il valore del codice a barre.

messages[]

object (Message)

Un array di messaggi visualizzati nell'app. Tutti gli utenti di questo oggetto riceveranno i messaggi associati. Il numero massimo di questi campi è 10.

validTimeInterval

object (TimeInterval)

Il periodo di tempo in cui questo oggetto sarà active e può essere utilizzato. Lo stato di un oggetto verrà modificato in expired una volta trascorso questo periodo di tempo.

locations[]

object (LatLongPoint)

Nota: questo campo non è attualmente supportato per attivare le notifiche geografiche.

hasUsers

boolean

Indica se l'oggetto ha utenti. Questo campo è impostato dalla piattaforma.

smartTapRedemptionValue

string

Il valore che per questo oggetto verrà trasmesso a un terminale certificato Smart Tap tramite NFC. Anche i campi a livello di corso enableSmartTap e redemptionIssuers devono essere configurati correttamente affinché il pass supporti la funzionalità Smart Tap. Sono supportati solo i caratteri ASCII.

hasLinkedDevice

boolean

Indica se questo oggetto è attualmente collegato a un singolo dispositivo. Questo campo viene impostato dalla piattaforma quando un utente salva l'oggetto, collegandolo al proprio dispositivo. Destinato all'utilizzo da parte di partner selezionati. Contatta l'assistenza per ulteriori informazioni.

disableExpirationNotification

boolean

Indica se le notifiche devono essere soppresse esplicitamente. Se questo campo viene impostato su true, indipendentemente dal campo messages, le notifiche di scadenza per l'utente verranno soppresse. Per impostazione predefinita, questo campo è impostato su false.

Al momento, può essere impostata solo per le offerte.

infoModuleData

object (InfoModuleData)

Deprecato. Usa invece textModulesData.

imageModulesData[]

object (ImageModuleData)

Dati del modulo Immagine. Il numero massimo di questi campi visualizzati è 1 a livello di oggetto e 1 a livello di oggetto classe.

textModulesData[]

object (TextModuleData)

Dati dei moduli di testo. Se nella classe sono definiti anche i dati del modulo di testo, verranno visualizzati entrambi. Il numero massimo di questi campi visualizzati è 10 dall'oggetto e 10 dalla classe.

rotatingBarcode

object (RotatingBarcode)

Il tipo e il valore del codice a barre rotante.

heroImage

object (Image)

Immagine del banner facoltativa visualizzata sulla parte anteriore della scheda. Se non è presente, verrà visualizzata un'immagine promozionale della classe, se presente. Se non è presente neanche l'immagine hero della classe, non verrà visualizzato nulla.

groupingInfo

object (GroupingInfo)

Informazioni che controllano il modo in cui le tessere vengono raggruppate insieme.

passConstraints

object (PassConstraints)

Passa i vincoli per l'oggetto. Include la limitazione dei comportamenti di NFC e screenshot.

Metodi

addmessage

Aggiunge un messaggio all'oggetto dell'offerta a cui fa riferimento l'ID oggetto specificato.

get

Restituisce l'oggetto offer con l'ID oggetto specificato.

insert

Inserisce un oggetto dell'offerta con l'ID e le proprietà specificati.

list

Restituisce un elenco di tutti gli oggetti dell'offerta per uno specifico ID emittente.

patch

Aggiorna l'oggetto offer a cui fa riferimento l'ID oggetto specificato.

update

Aggiorna l'oggetto offer a cui fa riferimento l'ID oggetto specificato.