REST Resource: eventticketclass

Risorsa: EventTicketClass

Rappresentazione JSON
{
  "kind": string,
  "eventName": {
    object (LocalizedString)
  },
  "eventId": string,
  "logo": {
    object (Image)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "confirmationCodeLabel": enum (ConfirmationCodeLabel),
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "seatLabel": enum (SeatLabel),
  "customSeatLabel": {
    object (LocalizedString)
  },
  "rowLabel": enum (RowLabel),
  "customRowLabel": {
    object (LocalizedString)
  },
  "sectionLabel": enum (SectionLabel),
  "customSectionLabel": {
    object (LocalizedString)
  },
  "gateLabel": enum (GateLabel),
  "customGateLabel": {
    object (LocalizedString)
  },
  "finePrint": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  }
}
Campi
kind
(deprecated)

string

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

eventName

object (LocalizedString)

obbligatorio. Il nome dell'evento, ad esempio "LA Dodgers al SF Giants".

eventId

string

L'ID dell'evento. Questo ID deve essere univoco per ogni evento in un account. Viene utilizzato per raggruppare i biglietti se l'utente ha salvato più biglietti per lo stesso evento. Può contenere al massimo 64 caratteri.

Se fornito, il raggruppamento sarà stabile. Fai attenzione ai conflitti involontari per evitare di raggruppare i ticket che non devono essere raggruppati. Se utilizzi un solo corso per evento, puoi semplicemente impostarlo su classId (con o senza la parte dell'ID emittente).

Se non viene specificato, la piattaforma tenterà di utilizzare altri dati per i ticket di gruppo (potenzialmente instabili).

venue

object (EventVenue)

Dettagli sulla sede dell'evento.

dateTime

object (EventDateTime)

Le informazioni sulla data e l'ora dell'evento.

confirmationCodeLabel

enum (ConfirmationCodeLabel)

L'etichetta da utilizzare per il valore del codice di conferma (eventTicketObject.reservationInfo.confirmationCode) nella visualizzazione dei dettagli della scheda. Ogni opzione disponibile è mappata a un insieme di stringhe localizzate, in modo che le traduzioni vengano mostrate all'utente in base alle sue impostazioni internazionali.

Non è possibile impostare sia confirmationCodeLabel che customConfirmationCodeLabel. Se nessuno dei due è impostato, per impostazione predefinita l'etichetta sarà "Codice di conferma", localizzato. Se il campo del codice di conferma non viene configurato, questa etichetta non verrà utilizzata.

customConfirmationCodeLabel

object (LocalizedString)

Un'etichetta personalizzata da utilizzare per il valore del codice di conferma (eventTicketObject.reservationInfo.confirmationCode) nella visualizzazione dei dettagli della scheda. Deve essere utilizzato solo se l'etichetta "Codice di conferma" predefinita o una delle opzioni confirmationCodeLabel non è sufficiente.

Non è possibile impostare sia confirmationCodeLabel che customConfirmationCodeLabel. Se nessuno dei due è impostato, per impostazione predefinita l'etichetta sarà "Codice di conferma", localizzato. Se il campo del codice di conferma non viene configurato, questa etichetta non verrà utilizzata.

seatLabel

enum (SeatLabel)

L'etichetta da utilizzare per il valore della utenza (eventTicketObject.seatInfo.seat) nella visualizzazione dei dettagli della scheda. Ogni opzione disponibile è mappata a un insieme di stringhe localizzate, in modo che le traduzioni vengano mostrate all'utente in base alle sue impostazioni internazionali.

Non è possibile impostare sia seatLabel che customSeatLabel. Se nessuna delle due è impostata, per impostazione predefinita l'etichetta sarà "Posto", localizzata. Se il campo della utenza non viene configurato, questa etichetta non verrà utilizzata.

customSeatLabel

object (LocalizedString)

Un'etichetta personalizzata da utilizzare per il valore utenza (eventTicketObject.seatInfo.seat) nella visualizzazione dei dettagli della scheda. Questa opzione deve essere utilizzata solo se l'etichetta predefinita "Posto" o una delle opzioni seatLabel non è sufficiente.

Non è possibile impostare sia seatLabel che customSeatLabel. Se nessuna delle due è impostata, per impostazione predefinita l'etichetta sarà "Posto", localizzata. Se il campo della utenza non viene configurato, questa etichetta non verrà utilizzata.

rowLabel

enum (RowLabel)

L'etichetta da utilizzare per il valore della riga (eventTicketObject.seatInfo.row) nella visualizzazione dei dettagli della scheda. Ogni opzione disponibile è mappata a un insieme di stringhe localizzate, in modo che le traduzioni vengano mostrate all'utente in base alle sue impostazioni internazionali.

Non è possibile impostare sia rowLabel che customRowLabel. Se nessuna delle due è impostata, per impostazione predefinita l'etichetta sarà "Riga", localizzata. Se il campo della riga non è impostato, questa etichetta non verrà utilizzata.

customRowLabel

object (LocalizedString)

Un'etichetta personalizzata da utilizzare per il valore della riga (eventTicketObject.seatInfo.row) nella visualizzazione dei dettagli della scheda. Deve essere utilizzato solo se l'etichetta "Riga" predefinita o una delle opzioni rowLabel non è sufficiente.

Non è possibile impostare sia rowLabel che customRowLabel. Se nessuna delle due è impostata, per impostazione predefinita l'etichetta sarà "Riga", localizzata. Se il campo della riga non è impostato, questa etichetta non verrà utilizzata.

sectionLabel

enum (SectionLabel)

L'etichetta da utilizzare per il valore della sezione (eventTicketObject.seatInfo.section) nella visualizzazione dei dettagli della scheda. Ogni opzione disponibile è mappata a un insieme di stringhe localizzate, in modo che le traduzioni vengano mostrate all'utente in base alle sue impostazioni internazionali.

Non è possibile impostare sia sectionLabel che customSectionLabel. Se nessuna delle due opzioni è impostata, per impostazione predefinita l'etichetta sarà "Sezione", localizzata. Se il campo della sezione non viene configurato, questa etichetta non verrà utilizzata.

customSectionLabel

object (LocalizedString)

Un'etichetta personalizzata da utilizzare per il valore della sezione (eventTicketObject.seatInfo.section) nella visualizzazione dei dettagli della scheda. Deve essere utilizzato solo se l'etichetta predefinita "Sezione" o una delle opzioni sectionLabel non è sufficiente.

Non è possibile impostare sia sectionLabel che customSectionLabel. Se nessuna delle due opzioni è impostata, per impostazione predefinita l'etichetta sarà "Sezione", localizzata. Se il campo della sezione non viene configurato, questa etichetta non verrà utilizzata.

gateLabel

enum (GateLabel)

L'etichetta da utilizzare per il valore della porta (eventTicketObject.seatInfo.gate) nella visualizzazione dei dettagli della scheda. Ogni opzione disponibile è mappata a un insieme di stringhe localizzate, in modo che le traduzioni vengano mostrate all'utente in base alle sue impostazioni internazionali.

Non è possibile impostare sia gateLabel che customGateLabel. Se nessuno dei due è impostato, per impostazione predefinita l'etichetta sarà "Gate", localizzata. Se il campo del gate non è impostato, questa etichetta non verrà utilizzata.

customGateLabel

object (LocalizedString)

Un'etichetta personalizzata da utilizzare per il valore della porta (eventTicketObject.seatInfo.gate) nella visualizzazione dei dettagli della scheda. Questa opzione deve essere utilizzata solo se l'etichetta predefinita "Gate" o una delle opzioni gateLabel non è sufficiente.

Non è possibile impostare sia gateLabel che customGateLabel. Se nessuno dei due è impostato, per impostazione predefinita l'etichetta sarà "Gate", localizzata. Se il campo del gate non è impostato, questa etichetta non verrà utilizzata.

finePrint

object (LocalizedString)

Clausole, termini o condizioni del biglietto.

classTemplateInfo

object (ClassTemplateInfo)

Informazioni sul modello su come deve essere visualizzato il corso. Se il criterio non viene configurato, Google utilizzerà un insieme predefinito di campi da visualizzare.

id

string

obbligatorio. L'identificatore univoco di una classe. Questo ID deve essere univoco per tutti i corsi 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 "-".

version
(deprecated)

string (int64 format)

Deprecata

issuerName

string

obbligatorio. Il nome dell'emittente. La lunghezza massima consigliata è di 20 caratteri per garantire che l'intera stringa venga visualizzata su schermi più piccoli.

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.

allowMultipleUsersPerObject
(deprecated)

boolean

Deprecato. Usa invece il criterio multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

L'URI della home page dell'applicazione. Il completamento dell'URI in questo campo comporta lo stesso comportamento di un URI in linksModuleData (quando viene visualizzato un oggetto, viene mostrato un link alla home page in quella che solitamente viene considerata la sezione linksModuleData dell'oggetto).

locations[]

object (LatLongPoint)

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

reviewStatus

enum (ReviewStatus)

obbligatorio. Lo stato del corso. Questo campo può essere impostato su draft o underReview utilizzando le chiamate API di inserimento, patch o aggiornamento. Una volta che lo stato della revisione passa da draft, non può essere reimpostato su draft.

Dovresti mantenere questo campo su draft quando il corso è in fase di sviluppo. Non è possibile utilizzare una classe draft per creare oggetti.

Imposta questo campo su underReview quando ritieni che il corso sia pronto per l'uso. La piattaforma imposterà automaticamente questo campo su approved e potrà essere utilizzato immediatamente per creare o migrare gli oggetti.

Quando aggiorni una classe già approved, devi continuare a impostare questo campo su underReview.

review

object (Review)

I commenti della recensione impostati dalla piattaforma quando un corso è contrassegnato come approved o rejected.

infoModuleData
(deprecated)

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.

redemptionIssuers[]

string (int64 format)

Identifica quali emittenti di promozioni possono utilizzare la tessera tramite Smart Tap. Gli emittenti di rimborsi sono identificati in base al loro ID emittente. Gli emittenti di promozioni devono avere almeno una chiave Smart Tap configurata.

Anche i campi enableSmartTap e smartTapRedemptionLevel a livello di oggetto devono essere configurati correttamente affinché una tessera supporti la funzionalità Smart Tap.

countryCode

string

Codice paese utilizzato per visualizzare il paese della scheda (quando l'utente non si trova in quel paese) e per visualizzare contenuti localizzati quando non sono disponibili nella lingua dell'utente.

heroImage

object (Image)

Immagine del banner facoltativa visualizzata sulla parte anteriore della scheda. Se non è presente, non verrà visualizzato nulla. L'immagine verrà visualizzata al 100% di larghezza.

wordMark
(deprecated)

object (Image)

Deprecato.

enableSmartTap

boolean

Identifica se questo corso supporta Smart Tap. Anche i campi redemptionIssuers e smartTapRedemptionLevel a livello di oggetto devono essere configurati correttamente affinché una tessera supporti la funzionalità Smart Tap.

hexBackgroundColor

string

Il colore di sfondo della scheda. Se non viene 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 usare la versione abbreviata della terzina RGB, che è #rgb, ad esempio #fc0.

localizedIssuerName

object (LocalizedString)

Stringhe tradotte per l'emittenteName. La lunghezza massima consigliata è di 20 caratteri per garantire che l'intera stringa venga visualizzata su schermi più piccoli.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Identifica se più utenti e dispositivi salveranno lo stesso oggetto con riferimento a questa classe.

callbackOptions

object (CallbackOptions)

Opzioni di callback da utilizzare per richiamare l'emittente a ogni salvataggio/eliminazione di un oggetto per questa classe da parte dell'utente finale. Tutti gli oggetti di questa classe sono idonei per il callback.

securityAnimation

object (SecurityAnimation)

Informazioni facoltative sull'animazione di sicurezza. Se questa impostazione è impostata, verrà visualizzata un'animazione di sicurezza nei dettagli del pass.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Visualizza le opzioni dei requisiti di sblocco per il biglietto per l'evento.

EventVenue

Rappresentazione JSON
{
  "kind": string,
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Campi
kind
(deprecated)

string

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

name

object (LocalizedString)

Il nome della sede, ad esempio "AT&T Park".

È obbligatoria.

address

object (LocalizedString)

L'indirizzo della sede dell'evento, ad esempio "24 Willie Mays Plaza\nSan Francisco, CA 94107". Le righe dell'indirizzo sono separate da caratteri di avanzamento riga (\n).

È obbligatoria.

EventDateTime

Rappresentazione JSON
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
Campi
kind
(deprecated)

string

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

doorsOpen

string

La data e l'ora di apertura delle porte della sede dell'evento.

Si tratta di un formato di data e ora in formato ISO 8601 esteso, con o senza un offset. Il tempo può essere specificato con una precisione fino a un nanosecondo. Gli offset possono essere specificati con precisione in secondi (anche se l'offset in secondi non fa parte di ISO 8601).

Ad esempio:

1985-04-12T23:20:50.52Z corrisponderà a 20 minuti e 50, 52 secondi dopo la 23a ora del 12 aprile 1985 nel fuso orario UTC.

1985-04-12T19:20:50.52-04:00 corrisponde a 20 minuti e 50, 52 secondi dopo la 19 ora del 12 aprile 1985, 4 ore prima di UTC (lo stesso istante dell'esempio riportato sopra). Se l'evento si trovasse a New York, sarebbe l'ora legale della costa orientale (EDT). Ricorda che l'offset varia nelle regioni in cui è osservata l'ora legale, a seconda del periodo dell'anno.

1985-04-12T19:20:50.52 corrisponde a 20 minuti e 50, 52 secondi dopo la 19a ora del 12 aprile 1985 senza informazioni di offset.

La parte di data/ora senza lo scarto è considerata la "data/ora locale". Deve essere la data e l'ora locali della sede. Ad esempio, se l'evento si verifica alla 20a ora del 5 giugno 2018 nella sede, la parte relativa a data/ora locale deve essere 2018-06-05T20:00:00. Se la data e l'ora locali della sede sono 4 ore prima dell'UTC, potrebbe essere aggiunto un offset di -04:00.

Senza informazioni di offset, alcune funzionalità avanzate potrebbero non essere disponibili.

start

string

La data e l'ora di inizio dell'evento. Se l'evento si estende su più giorni, deve essere la data o l'ora di inizio del primo giorno.

Si tratta di un formato di data e ora in formato ISO 8601 esteso, con o senza un offset. Il tempo può essere specificato con una precisione fino a un nanosecondo. Gli offset possono essere specificati con precisione in secondi (anche se l'offset in secondi non fa parte di ISO 8601).

Ad esempio:

1985-04-12T23:20:50.52Z corrisponderà a 20 minuti e 50, 52 secondi dopo la 23a ora del 12 aprile 1985 nel fuso orario UTC.

1985-04-12T19:20:50.52-04:00 corrisponde a 20 minuti e 50, 52 secondi dopo la 19 ora del 12 aprile 1985, 4 ore prima di UTC (lo stesso istante dell'esempio riportato sopra). Se l'evento si trovasse a New York, sarebbe l'ora legale della costa orientale (EDT). Ricorda che l'offset varia nelle regioni in cui è osservata l'ora legale, a seconda del periodo dell'anno.

1985-04-12T19:20:50.52 corrisponde a 20 minuti e 50, 52 secondi dopo la 19a ora del 12 aprile 1985 senza informazioni di offset.

La parte di data/ora senza lo scarto è considerata la "data/ora locale". Deve essere la data e l'ora locali della sede. Ad esempio, se l'evento si verifica alla 20a ora del 5 giugno 2018 nella sede, la parte relativa a data/ora locale deve essere 2018-06-05T20:00:00. Se la data e l'ora locali della sede sono 4 ore prima dell'UTC, potrebbe essere aggiunto un offset di -04:00.

Senza informazioni di offset, alcune funzionalità avanzate potrebbero non essere disponibili.

end

string

La data e l'ora in cui termina l'evento. Se l'evento si estende su più giorni, deve essere la data e l'ora di fine dell'ultimo giorno.

Si tratta di un formato di data e ora in formato ISO 8601 esteso, con o senza un offset. Il tempo può essere specificato con una precisione fino a un nanosecondo. Gli offset possono essere specificati con precisione in secondi (anche se l'offset in secondi non fa parte di ISO 8601).

Ad esempio:

1985-04-12T23:20:50.52Z corrisponderà a 20 minuti e 50, 52 secondi dopo la 23a ora del 12 aprile 1985 nel fuso orario UTC.

1985-04-12T19:20:50.52-04:00 corrisponde a 20 minuti e 50, 52 secondi dopo la 19 ora del 12 aprile 1985, 4 ore prima di UTC (lo stesso istante dell'esempio riportato sopra). Se l'evento si trovasse a New York, sarebbe l'ora legale della costa orientale (EDT). Ricorda che l'offset varia nelle regioni in cui è osservata l'ora legale, a seconda del periodo dell'anno.

1985-04-12T19:20:50.52 corrisponde a 20 minuti e 50, 52 secondi dopo la 19a ora del 12 aprile 1985 senza informazioni di offset.

La parte di data/ora senza lo scarto è considerata la "data/ora locale". Deve essere la data e l'ora locali della sede. Ad esempio, se l'evento si verifica alla 20a ora del 5 giugno 2018 nella sede, la parte relativa a data/ora locale deve essere 2018-06-05T20:00:00. Se la data e l'ora locali della sede sono 4 ore prima dell'UTC, potrebbe essere aggiunto un offset di -04:00.

Senza informazioni di offset, alcune funzionalità avanzate potrebbero non essere disponibili.

doorsOpenLabel

enum (DoorsOpenLabel)

L'etichetta da utilizzare per il valore di apertura delle porte (doorsOpen) nella visualizzazione dei dettagli della scheda. Ogni opzione disponibile è mappata a un insieme di stringhe localizzate, in modo che le traduzioni vengano mostrate all'utente in base alle sue impostazioni internazionali.

Non è possibile impostare sia doorsOpenLabel che customDoorsOpenLabel. Se nessuna delle due è impostata, per impostazione predefinita l'etichetta sarà "Porte aperte", localizzata. Se il campo Porte aperte non è impostato, questa etichetta non verrà utilizzata.

customDoorsOpenLabel

object (LocalizedString)

Un'etichetta personalizzata da utilizzare per il valore di apertura delle porte (doorsOpen) nella visualizzazione dei dettagli della scheda. Deve essere utilizzato solo se l'etichetta predefinita "Porte aperte" o una delle opzioni doorsOpenLabel non è sufficiente.

Non è possibile impostare sia doorsOpenLabel che customDoorsOpenLabel. Se nessuna delle due è impostata, per impostazione predefinita l'etichetta sarà "Porte aperte", localizzata. Se il campo Porte aperte non è impostato, questa etichetta non verrà utilizzata.

DoorsOpenLabel

Enum
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

Alias precedente per DOORS_OPEN. Deprecato.

GATES_OPEN
gatesOpen

Alias precedente per GATES_OPEN. Deprecato.

ConfirmationCodeLabel

Enum
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

Alias precedente per CONFIRMATION_CODE. Deprecato.

CONFIRMATION_NUMBER
confirmationNumber

Alias precedente per CONFIRMATION_NUMBER. Deprecato.

ORDER_NUMBER
orderNumber

Alias precedente per ORDER_NUMBER. Deprecato.

RESERVATION_NUMBER
reservationNumber

Alias precedente per RESERVATION_NUMBER. Deprecato.

SeatLabel

Enum
SEAT_LABEL_UNSPECIFIED
SEAT
seat

Alias precedente per SEAT. Deprecato.

RowLabel

Enum
ROW_LABEL_UNSPECIFIED
ROW
row

Alias precedente per ROW. Deprecato.

SectionLabel

Enum
SECTION_LABEL_UNSPECIFIED
SECTION
section

Alias precedente per SECTION. Deprecato.

THEATER
theater

Alias precedente per THEATER. Deprecato.

GateLabel

Enum
GATE_LABEL_UNSPECIFIED
GATE
gate

Alias precedente per GATE. Deprecato.

DOOR
door

Alias precedente per DOOR. Deprecato.

ENTRANCE
entrance

Alias precedente per ENTRANCE. Deprecato.

Metodi

addmessage

Aggiunge un messaggio alla classe di biglietti per l'evento a cui fa riferimento l'ID corso specificato.

get

Restituisce la classe di biglietto dell'evento con l'ID classe specificato.

insert

Inserisce una classe di biglietti per un evento con l'ID e le proprietà specificati.

list

Restituisce un elenco di tutte le classi di biglietti per un evento per uno specifico ID emittente.

patch

Aggiorna la classe di biglietti per un evento a cui fa riferimento l'ID corso specificato.

update

Aggiorna la classe di biglietti per un evento a cui fa riferimento l'ID corso specificato.