REST Resource: flightclass

Risorsa: FlightClass

Rappresentazione JSON
{
  "kind": string,
  "localScheduledDepartureDateTime": string,
  "localEstimatedOrActualDepartureDateTime": string,
  "localBoardingDateTime": string,
  "localScheduledArrivalDateTime": string,
  "localEstimatedOrActualArrivalDateTime": string,
  "flightHeader": {
    object (FlightHeader)
  },
  "origin": {
    object (AirportInfo)
  },
  "destination": {
    object (AirportInfo)
  },
  "flightStatus": enum (FlightStatus),
  "boardingAndSeatingPolicy": {
    object (BoardingAndSeatingPolicy)
  },
  "localGateClosingDateTime": string,
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "languageOverride": string,
  "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),
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Campi
kind
(deprecated)

string

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

localScheduledDepartureDateTime

string

Obbligatorio. La data e l'ora programmate in cui l'aereo dovrebbe partire dal gate (non dalla pista)

Nota: questo campo non deve cambiare troppo vicino all'ora di partenza. Per aggiornamenti sugli orari di partenza (ritardi e così via), imposta localEstimatedOrActualDepartureDateTime.

Si tratta di una data/ora nel formato esteso ISO 8601 senza un offset. L'ora può essere specificata con una precisione fino a millisecondi.

ad es. 2027-03-05T06:30:00

Deve essere la data/l'ora locale dell'aeroporto (non l'ora UTC).

Google rifiuterà la richiesta se viene fornito lo scarto da UTC. I fusi orari verranno calcolati da Google in base all'aeroporto di partenza.

localEstimatedOrActualDepartureDateTime

string

L'orario stimato in cui l'aereo dovrebbe partire dal gate o l'orario effettivo in cui l'aereo è già partito dal gate. Nota: questo non è il momento della passerella.

Questo campo deve essere impostato se almeno una delle seguenti condizioni è vera:

  • È diverso dall'orario programmato. Google la utilizzerà per calcolare il ritardo.
  • L'aereo è già partito dal gate. Google le utilizzerà per informare l'utente della partenza effettiva del volo.

Si tratta di una data/ora nel formato esteso ISO 8601 senza un offset. Il tempo può essere specificato con una precisione fino a millisecondi.

ad es. 2027-03-05T06:30:00

Deve essere la data/l'ora locale dell'aeroporto (non l'ora UTC).

Google rifiuterà la richiesta se viene fornito lo scarto da UTC. I fusi orari verranno calcolati da Google in base all'aeroporto di partenza.

localBoardingDateTime

string

L'ora di imbarco come stampata sulla carta d'imbarco.

Data/ora nel formato esteso ISO 8601 senza offset. Il tempo può essere specificato con una precisione in millisecondi.

ad es. 2027-03-05T06:30:00

Deve essere la data/l'ora locale dell'aeroporto (non l'ora UTC).

Google rifiuterà la richiesta se viene fornita la differenza UTC. I fusi orari saranno calcolati da Google in base all'aeroporto di partenza.

localScheduledArrivalDateTime

string

L'ora programmata in cui l'aereo prevede di raggiungere il gate di destinazione (non la pista).

Nota: questo campo non deve cambiare troppo vicino all'orario del volo. Per aggiornamenti sugli orari di partenza (ritardi e così via), imposta localEstimatedOrActualArrivalDateTime.

Si tratta di una data/ora nel formato esteso ISO 8601 senza un offset. Il tempo può essere specificato con una precisione in millisecondi.

ad es. 2027-03-05T06:30:00

Deve essere la data/l'ora locale dell'aeroporto (non l'ora UTC).

Google rifiuterà la richiesta se viene fornito lo scarto da UTC. I fusi orari verranno calcolati da Google in base all'aeroporto di arrivo.

localEstimatedOrActualArrivalDateTime

string

L'orario stimato in cui l'aereo prevede di raggiungere la porta di destinazione (non la pista) o l'orario effettivo in cui ha raggiunto la porta.

Questo campo deve essere impostato se almeno una delle seguenti condizioni è vera:

  • È diverso dall'orario programmato. Google la utilizzerà per calcolare il ritardo.
  • L'aereo è già arrivato al gate. Google la utilizzerà per informare l'utente che il volo è arrivato al gate.

Data/ora nel formato esteso ISO 8601 senza offset. Il tempo può essere specificato con una precisione in millisecondi.

ad es. 2027-03-05T06:30:00

Deve essere la data/l'ora locale dell'aeroporto (non l'ora UTC).

Google rifiuterà la richiesta se viene fornito lo scarto da UTC. I fusi orari verranno calcolati da Google in base all'aeroporto di arrivo.

flightHeader

object (FlightHeader)

Obbligatorio. Informazioni sul numero e sul vettore del volo.

origin

object (AirportInfo)

Obbligatorio. Aeroporto di partenza.

destination

object (AirportInfo)

Obbligatorio. Aeroporto di destinazione.

flightStatus

enum (FlightStatus)

Stato di questo volo.

Se non impostato, Google calcola lo stato in base ai dati di altre origini, come FlightStats e così via.

Nota: lo stato calcolato da Google non verrà restituito nelle risposte dell'API.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Norme relative a imbarco e posti a sedere. Questi valori indicano quali etichette verranno mostrate agli utenti.

localGateClosingDateTime

string

L'orario di chiusura del gate così come verrebbe stampato sulla carta d'imbarco. Non impostare questo campo se non vuoi che venga stampato nella carta d'imbarco.

Si tratta di una data/ora nel formato esteso ISO 8601 senza un offset. Il tempo può essere specificato con una precisione in millisecondi.

ad es. 2027-03-05T06:30:00

Deve essere la data/l'ora locale dell'aeroporto (non l'ora UTC).

Google rifiuterà la richiesta se viene fornita la differenza UTC. I fusi orari saranno calcolati da Google in base all'aeroporto di partenza.

classTemplateInfo

object (ClassTemplateInfo)

Informazioni sul modello relative alla visualizzazione del corso. Se non viene impostato, Google utilizzerà un insieme predefinito di campi da visualizzare.

languageOverride

string

Se questo campo è presente, le tessere di imbarco inviate al dispositivo di un utente saranno sempre in questa lingua. Rappresenta il tag lingua BCP 47. I valori di esempio sono "en-US", "en-GB", "de" o "de-AT".

id

string

Obbligatorio. L'identificatore univoco di un corso. Questo ID deve essere univoco in tutte le classi di un emittente. Questo valore deve seguire il formato issuer ID.identifier, dove il primo è emesso da Google e il secondo è scelto da te. Il tuo identificatore univoco deve includere solo caratteri alfanumerici, ".", "_" o "-".

version
(deprecated)

string (int64 format)

Deprecato

issuerName

string

Obbligatorio. Il nome dell'emittente. La lunghezza massima consigliata è di 20 caratteri per garantire che la stringa completa 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. Utilizza invece multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

L'URI della home page dell'applicazione. Se compili l'URI in questo campo, il comportamento è esattamente lo stesso di quello che si ottiene compilando un URI in linksModuleData (quando viene visualizzato un oggetto, un link alla home page viene mostrato nella sezione linksModuleData dell'oggetto).

locations[]
(deprecated)

object (LatLongPoint)

Nota: al momento questo campo non è 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 cambiato lo stato della revisione da draft, non è possibile tornare a draft.

Quando il corso è in fase di sviluppo, devi mantenere questo campo su draft. Non è possibile utilizzare una classe draft per creare alcun oggetto.

Devi impostare 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 eseguire la migrazione di oggetti.

Quando aggiorni un corso 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. Utilizza 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.

redemptionIssuers[]

string (int64 format)

Identifica gli emittenti di coupon che possono utilizzare la tessera tramite Smart Tap. Gli emittenti dei premi sono identificati dal relativo ID emittente. Gli emittenti di coupon devono avere configurato almeno una chiave Smart Tap.

Anche i campi enableSmartTap e smartTapRedemptionLevel a livello di oggetto devono essere configurati correttamente affinché una tessera supporti il tocco intelligente.

countryCode

string

Codice paese utilizzato per visualizzare il paese della scheda (se l'utente non si trova in quel paese) e per visualizzare i 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% della larghezza.

wordMark
(deprecated)

object (Image)

Deprecato.

enableSmartTap

boolean

Indica se il corso supporta Smart Tap. Anche i campi redemptionIssuers e smartTapRedemptionLevel a livello di oggetto devono essere configurati correttamente affinché una tessera supporti il tocco intelligente.

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, ovvero #rgb, ad esempio #fc0.

localizedIssuerName

object (LocalizedString)

Stringhe tradotte per issuerName. La lunghezza massima consigliata è di 20 caratteri per garantire che la stringa completa venga visualizzata su schermi più piccoli.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

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

callbackOptions

object (CallbackOptions)

Opzioni di callback da utilizzare per richiamare l'emittente per 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 opzione è impostata, verrà visualizzata un'animazione di sicurezza nei dettagli della tessera.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Visualizza le opzioni per i requisiti di sblocco della carta d'imbarco.

notifyPreference

enum (NotificationSettingsForUpdates)

Indica se gli aggiornamenti dei campi di questa classe devono attivare o meno le notifiche. Se impostato su NOTIFY, si proverà ad attivare una notifica di aggiornamento dei campi per gli utenti. Queste notifiche verranno inviate agli utenti solo se il campo fa parte di una lista consentita. Se non viene specificato, 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 per corso. Per una tessera ne verranno visualizzate solo dieci, dando la priorità a quelle dell'oggetto.

FlightHeader

Rappresentazione JSON
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
Campi
kind
(deprecated)

string

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

carrier

object (FlightCarrier)

Informazioni sulla compagnia aerea. Si tratta di una proprietà obbligatoria di flightHeader.

flightNumber

string

Il numero del volo senza il codice IATA della compagnia aerea. Questo campo deve contenere solo cifre. Si tratta di una proprietà obbligatoria di flightHeader.

ad es. "123"

operatingCarrier

object (FlightCarrier)

Informazioni sulla compagnia aerea operativa.

operatingFlightNumber

string

Il numero del volo utilizzato dal vettore operativo senza il codice IATA del vettore. Questo campo deve contenere solo cifre.

ad es. "234"

flightNumberDisplayOverride

string

Valore da sostituire per il numero di volo. Il valore predefinito utilizzato per la visualizzazione è vettore + voloNumber. Se è necessario mostrare un valore diverso ai passeggeri, utilizza questo campo per sostituire il comportamento predefinito.

ad es. "XX1234 / YY576"

FlightCarrier

Rappresentazione JSON
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
Campi
kind
(deprecated)

string

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

carrierIataCode

string

Codice IATA di due caratteri della compagnia aerea del vettore di marketing (diverso dal vettore operativo). È necessario fornire esattamente uno di questi elementi o carrierIcaoCode per carrier e operatingCarrier.

ad es. "LX" per Swiss Air

carrierIcaoCode

string

Codice ICAO di tre caratteri della compagnia aerea del vettore di marketing (diverso dal vettore operativo). Per carrier e operatingCarrier deve essere specificato esattamente uno di questo o carrierIataCode.

Esempio: "EZY" per Easy Jet

airlineName

object (LocalizedString)

Il nome localizzato della compagnia aerea specificata dal vettoreIataCode. Se non viene impostato, per la visualizzazione verranno utilizzati issuerName o localizedIssuerName da FlightClass.

ad es. "Swiss Air" per "LX"

AirportInfo

Rappresentazione JSON
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
Campi
kind
(deprecated)

string

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

airportIataCode

string

Codice IATA dell'aeroporto di tre caratteri. Questo campo è obbligatorio per origin e destination.

Esempio: "SFO"

terminal

string

Nome del terminale. Ad esempio, "INTL" o "I"

gate

string

Un nome per la porta. Esempio: "B59" o "59"

airportNameOverride

object (LocalizedString)

Campo facoltativo che sostituisce il nome della città dell'aeroporto definito dall'IATA. Per impostazione predefinita, Google prende il airportIataCode fornito e lo mappa al nome ufficiale della città dell'aeroporto definito dall'IATA.

I nomi ufficiali delle città degli aeroporti IATA sono disponibili sul sito web Nomi delle città degli aeroporti IATA. Ad esempio, per il codice IATA dell'aeroporto "LTN", il sito web IATA ci dice che la città dell'aeroporto corrispondente è "Londra".

Se questo campo non viene compilato, Google mostrerà "Londra".

Tuttavia, se completi questo campo con un nome personalizzato (ad es. "Londra Luton"), questo verrà sostituito.

FlightStatus

Enum
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED Il volo è in orario, in anticipo o in ritardo.
scheduled

Alias precedente per SCHEDULED. Deprecato.

ACTIVE Il volo è in corso (rullaggio, decollo, atterraggio, volo).
active

Alias precedente per ACTIVE. Deprecato.

LANDED Il volo è atterrato nella destinazione originale.
landed

Alias precedente per LANDED. Deprecato.

CANCELLED Il volo è stato annullato.
cancelled

Alias precedente per CANCELLED. Deprecato.

REDIRECTED Il volo è in volo, ma è diretto a un aeroporto diverso rispetto alla destinazione originale.
redirected

Alias precedente per REDIRECTED. Deprecato.

DIVERTED Il volo è già atterrato in un aeroporto diverso rispetto alla destinazione originale.
diverted

Alias precedente per DIVERTED. Deprecato.

BoardingAndSeatingPolicy

Rappresentazione JSON
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
Campi
kind
(deprecated)

string

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

boardingPolicy

enum (BoardingPolicy)

Indica le norme utilizzate dalla compagnia aerea per l'imbarco. Se non viene impostato, Google utilizzerà zoneBased come valore predefinito.

seatClassPolicy

enum (SeatClassPolicy)

Norme relative ai posti che stabiliscono la modalità di visualizzazione della classe. Se non viene impostato, Google utilizzerà cabinBased come valore predefinito.

BoardingPolicy

Enum
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

Alias precedente per ZONE_BASED. Deprecato.

GROUP_BASED
groupBased

Alias precedente per GROUP_BASED. Deprecato.

BOARDING_POLICY_OTHER
boardingPolicyOther

Alias precedente per BOARDING_POLICY_OTHER. Deprecato.

SeatClassPolicy

Enum
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

Alias precedente per CABIN_BASED. Deprecato.

CLASS_BASED
classBased

Alias precedente per CLASS_BASED. Deprecato.

TIER_BASED
tierBased

Alias precedente per TIER_BASED. Deprecato.

SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

Alias precedente per SEAT_CLASS_POLICY_OTHER. Deprecato.

Metodi

addmessage

Aggiunge un messaggio alla classe di volo a cui fa riferimento l'ID classe specificato.

get

Restituisce la classe di volo con l'ID classe specificato.

insert

Inserisce una classe di volo con l'ID e le proprietà specificati.

list

Restituisce un elenco di tutte le classi di volo per un determinato ID emittente.

patch

Aggiorna la classe di volo a cui fa riferimento l'ID classe specificato.

update

Aggiorna la classe di volo a cui fa riferimento l'ID classe specificato.