REST Resource: flightobject

Risorsa: FlightObject

Rappresentazione JSON
{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "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)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "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#flightObject".

classReference

object (FlightClass)

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

passengerName

string

Obbligatorio. Il nome del passeggero come appare sulla carta d'imbarco.

ad es. "Dave M Gahan" o "Gahan/Dave" o "GAHAN/DAVEM"

boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

Informazioni specifiche per i passeggeri su imbarco e posti a sedere.

reservationInfo

object (ReservationInfo)

Obbligatorio. Informazioni sulla prenotazione del volo.

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 terzina RGB esadecimale, ad esempio #ffcc00. Puoi anche utilizzare la versione abbreviata della tripletta RGB, ovvero #rgb, 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 seguire il formato issuer ID.identifier: il primo viene emesso da Google, mentre 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 essere nel 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 come 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 l'oggetto può essere utilizzato. Al termine di questo periodo di tempo, lo stato di un oggetto verrà modificato in expired.

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 a 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 i voli.

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 rotante.

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.

groupingInfo

object (GroupingInfo)

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

passConstraints

object (PassConstraints)

Passa i vincoli per l'oggetto. Include la limitazione dei comportamenti dell'NFC e degli 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, trasporto pubblico e carte d'imbarco, che devono essere collegati automaticamente a questo oggetto volo. Se un utente avesse salvato questa carta d'imbarco, questi linkedObjectId verrebbero inviati automaticamente al suo portafoglio (a meno che non abbia disattivato l'impostazione per ricevere queste tessere collegate).

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 automaticamente.

Gli ID oggetto devono essere nel 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 per 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 a valore aggiunto. Massimo dieci nell'oggetto.

BoardingAndSeatingInfo

Rappresentazione JSON
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
Campi
kind
(deprecated)

string

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

boardingGroup

string

Il valore del gruppo di imbarco (o della zona) con cui il passeggero deve salire a bordo.

Es.: "B"

L'etichetta per questo valore verrà determinata dal campo boardingPolicy in flightClass a cui fa riferimento questo oggetto.

seatNumber

string

Il valore del sedile del passeggero. Se non è presente un identificatore specifico, utilizza seatAssignment.

ad es. "25A"

seatClass

string

Il valore della classe.

ad es. "Economy" o "Economy Plus"

boardingPrivilegeImage

object (Image)

Una piccola immagine sopra il codice a barre di imbarco. Le compagnie aeree possono utilizzarlo per comunicare eventuali privilegi di imbarco speciali. Se è impostato anche il logo del programma di sicurezza, questa immagine potrebbe essere visualizzata insieme al logo del programma di sicurezza.

boardingPosition

string

Il valore della posizione di bordo.

ad es. "76"

sequenceNumber

string

Il numero di sequenza sulla carta d'imbarco. In genere corrisponde alla sequenza in cui i passeggeri hanno effettuato il check-in. La compagnia aerea potrebbe utilizzare il numero per l'imbarco manuale e i tag relativi ai bagagli.

ad es. "49"

boardingDoor

enum (BoardingDoor)

Imposta questo campo solo se il volo parte da più di una porta o da un ponte e vuoi stampare esplicitamente la posizione della porta sulla carta d'imbarco. La maggior parte delle compagnie aeree indirizza i passeggeri alla porta o alla passerella giusta facendo riferimento alle porte/passerelle tramite il seatClass. In questi casi, boardingDoor non deve essere impostato.

seatAssignment

object (LocalizedString)

L'assegnazione del posto del passeggero. Da utilizzare quando non esistono identificatori specifici da usare in seatNumber.

ad es. "assegnato al cancello"

BoardingDoor

Enum
BOARDING_DOOR_UNSPECIFIED
FRONT
front

Alias precedente per FRONT. Deprecato.

BACK
back

Alias precedente per BACK. Deprecato.

ReservationInfo

Rappresentazione JSON
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
Campi
kind
(deprecated)

string

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

confirmationCode

string

Codice di conferma necessario per effettuare il check-in per questo volo.

È il numero che il passeggero deve inserire in un chiosco all'aeroporto per cercare il volo e stampare la carta d'imbarco.

eticketNumber

string

Numero del biglietto elettronico.

frequentFlyerInfo

object (FrequentFlyerInfo)

Dati della tessera del programma frequent flyer.

FrequentFlyerInfo

Rappresentazione JSON
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
Campi
kind
(deprecated)

string

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

frequentFlyerProgramName

object (LocalizedString)

Nome del programma frequent flyer, ad esempio "Lufthansa Miles & More"

frequentFlyerNumber

string

Numero del programma frequent flyer.

Obbligatorio per ogni oggetto nidificato di tipo walletobjects#frequentFlyerInfo.

Metodi

addmessage

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

get

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

insert

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

list

Restituisce un elenco di tutti gli oggettiflight per un determinato ID emittente.

patch

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

update

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