REST Resource: eventticketobject

Risorsa: EventTicketObject

Rappresentazione JSON
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "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)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Campi
kind
(deprecated)

string

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

classReference

object (EventTicketClass)

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

seatInfo

object (EventSeat)

Dettagli dei posti per questo biglietto.

reservationInfo

object (EventReservationInfo)

Dettagli della prenotazione per questo biglietto. Questo valore dovrebbe essere condiviso tra tutti i biglietti acquistati nello stesso ordine.

ticketHolderName

string

Nome del titolare del biglietto, se il biglietto è assegnato a una persona. Ad esempio "Mario Rossi" o "Maria Rossi".

ticketNumber

string

Il numero del biglietto. Può essere un identificatore univoco per tutti i biglietti nel sistema di un emittente, per tutti i biglietti per l'evento (ad es. XYZ1234512345) o per tutti i biglietti nell'ordine (1, 2, 3 e così via).

ticketType

object (LocalizedString)

Il tipo di biglietto, ad esempio "Adulto" o "Bambino" oppure "VIP" o "Standard".

faceValue

object (Money)

Il valore nominale del biglietto, corrispondente a quello stampato su una versione fisica del biglietto.

groupingInfo

object (GroupingInfo)

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

linkedOfferIds[]

string

Un elenco di oggetti di offerta collegati a questo biglietto per l'evento. Gli oggetti di offerta devono già esistere.

Gli ID oggetto dell'offerta devono seguire il formato issuer ID.identifier, dove il primo è emesso da Google e il secondo è scelto da te.

hexBackgroundColor

string

Il colore di sfondo della scheda. Se non è impostato, viene utilizzato il colore dominante dell'immagine hero e, se non è impostata alcuna immagine hero, viene utilizzato il colore dominante del logo. Il formato è #rrggbb, dove rrggbb è una tripletta RGB esadecimale, ad esempio #ffcc00. Puoi anche utilizzare la versione abbreviata della tripletta RGB che è #Googlebot, ad esempio #fc0.

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 il primo è emesso da Google e il secondo è scelto da te. L'identificatore univoco deve includere solo caratteri alfanumerici, ".", "_" o "-".

classId

string

Obbligatorio. La classe associata a questo oggetto. La classe deve essere dello stesso tipo dell'oggetto, deve esistere già e deve essere approvata.

Gli ID classe devono seguire il formato issuer ID.identifier, dove il primo è emesso da Google e il secondo è scelto da te.

version
(deprecated)

string (int64 format)

Deprecato

state

enum (State)

Obbligatorio. Lo stato dell'oggetto. Questo campo viene utilizzato per determinare la modalità di visualizzazione di un oggetto 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 l'oggetto può essere utilizzato. Lo stato di un oggetto verrà modificato in expired al termine di questo periodo di tempo.

locations[]
(deprecated)

object (LatLongPoint)

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

hasUsers

boolean

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

smartTapRedemptionValue

string

Il valore che verrà trasmesso a un terminale certificato Smart Tap tramite NFC per questo oggetto. Anche i campi a livello di classe enableSmartTap e redemptionIssuers devono essere configurati correttamente affinché la tessera 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 soppressate esplicitamente. Se questo campo è impostato su true, indipendentemente dal campo messages, le notifiche di scadenza all'utente verranno eliminate. Per impostazione predefinita, questo campo è impostato su false.

Al momento, questa opzione 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 della classe.

textModulesData[]

object (TextModuleData)

Dati del modulo di testo. Se nel corso 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 in rotazione.

heroImage

object (Image)

Immagine del banner facoltativa visualizzata sulla parte anteriore della scheda. Se non è presente, verrà visualizzata l'immagine hero del corso, se presente. Se non è presente nemmeno l'immagine hero del corso, non verrà visualizzata alcuna immagine.

passConstraints

object (PassConstraints)

Passa i vincoli per l'oggetto. Sono inclusi i comportamenti di limitazione di NFC e screenshot.

saveRestrictions

object (SaveRestrictions)

Restrizioni relative all'oggetto che devono essere verificate prima che l'utente provi a salvare la tessera. Tieni presente che queste limitazioni verranno applicate solo durante il tempo di salvataggio. Se le limitazioni sono cambiate dopo che un utente ha salvato la tessera, le nuove limitazioni non verranno applicate a una tessera già salvata.

linkedObjectIds[]

string

linkedObjectIds è un elenco di altri oggetti, come biglietti per eventi, fedeltà, offerte, generici, carte regalo, per il trasporto pubblico e carte d'imbarco, che devono essere collegati automaticamente a questo oggetto biglietto per eventi. Se un utente avesse salvato questo biglietto per un evento, questi ID oggetti collegati sarebbero stati inviati automaticamente al suo wallet (a meno che non avesse disattivato l'impostazione per ricevere i documenti collegati).

Assicurati che gli oggetti presenti in linkedObjectIds siano già inseriti. In caso contrario, le chiamate non andranno a buon fine. Una volta collegati, gli oggetti collegati non possono essere scollegati. Non puoi collegare oggetti appartenenti a un altro emittente. Esiste un limite al numero di oggetti che possono essere collegati a un singolo oggetto. Una volta raggiunto il limite, i nuovi oggetti collegati nella chiamata verranno ignorati silenziosamente.

Gli ID oggetto devono seguire il formato issuer ID.identifier, dove il primo è emesso da Google e il secondo è scelto da te.

notifyPreference

enum (NotificationSettingsForUpdates)

Indica se gli aggiornamenti dei campi di questo oggetto devono attivare o meno le notifiche. Se impostato su NOTIFY, tenteremo di attivare una notifica di aggiornamento del campo per gli utenti. Queste notifiche verranno inviate agli utenti solo se il campo fa parte di una lista consentita. Se impostato su DO_NOT_NOTIFY o NOTIFICATION_SETTINGS_UNSPECIFIED, non verrà attivata alcuna notifica. Questa impostazione è temporanea e deve essere impostata con ogni richiesta PATCH o UPDATE, altrimenti non verrà attivata una notifica.

valueAddedModuleData[]

object (ValueAddedModuleData)

Dati facoltativi del modulo sul valore aggiunto. Massimo dieci nell'oggetto.

EventSeat

Rappresentazione JSON
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Campi
kind
(deprecated)

string

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

seat

object (LocalizedString)

Il numero del posto, ad esempio "1", "2", "3" o qualsiasi altro identificatore del posto.

Questo campo è localizzabile, quindi puoi tradurre le parole o utilizzare alfabeti diversi per i caratteri di un identificatore.

row

object (LocalizedString)

La fila del sedile, ad esempio "1", E", "BB" o "A5".

Questo campo è localizzabile, quindi puoi tradurre le parole o utilizzare alfabeti diversi per i caratteri di un identificatore.

section

object (LocalizedString)

La sezione del posto, ad esempio "121".

Questo campo è localizzabile, quindi puoi tradurre le parole o utilizzare alfabeti diversi per i caratteri di un identificatore.

gate

object (LocalizedString)

Il varco da cui il titolare del biglietto deve accedere per raggiungere il proprio posto, ad esempio "A" o "Ovest".

Questo campo è localizzabile, quindi puoi tradurre le parole o utilizzare alfabeti diversi per i caratteri di un identificatore.

EventReservationInfo

Rappresentazione JSON
{
  "kind": string,
  "confirmationCode": string
}
Campi
kind
(deprecated)

string

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

confirmationCode

string

Il codice di conferma della prenotazione dell'evento. Può anche assumere la forma di un "numero d'ordine", "numero di conferma", "numero di prenotazione" o altro equivalente.

Metodi

addmessage

Aggiunge un messaggio all'oggetto biglietto evento a cui fa riferimento l'ID oggetto specificato.

get

Restituisce l'oggetto ticket evento con l'ID oggetto specificato.

insert

Inserisce un oggetto biglietto evento con l'ID e le proprietà specificati.

list

Restituisce un elenco di tutti gli oggetti biglietto per un determinato ID emittente.

modifylinkedofferobjects

Modifica gli oggetti delle offerte collegate per l'oggetto biglietto evento con l'ID specificato.

patch

Aggiorna l'oggetto ticket eventi a cui fa riferimento l'ID oggetto specificato.

update

Aggiorna l'oggetto biglietto evento a cui fa riferimento l'ID oggetto specificato.