REST Resource: flightclass

Zasób: FlightClass

Zapis 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)
}
Pola
kind
(deprecated)

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#flightClass".

localScheduledDepartureDateTime

string

To pole jest wymagane. Planowana data i godzina odejścia samolotu od bramki (a nie pasa startowego).

Uwaga: to pole nie powinno ulegać zmianie zbyt blisko godziny odjazdu. Do aktualizowania godzin odlotów (opóźnienia itp.) należy używać localEstimatedOrActualDepartureDateTime.

Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia. Godzinę można określić z dokładnością do milisekundy.

np. 2027-03-05T06:30:00

Powinna to być lokalna data i godzina na lotnisku (a nie czas UTC).

Jeśli jest podane przesunięcie względem czasu UTC, Google odrzuci tę prośbę. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska wylotu.

localEstimatedOrActualDepartureDateTime

string

Szacowana godzina zamierzonego odejścia samolotu od bramki lub faktyczna godzina odejścia samolotu od bramki. Uwaga: to nie jest czas wyświetlania na pasie startowym.

To pole należy ustawić, jeśli spełniony jest co najmniej jeden z tych warunków:

  • Jest inna niż zaplanowana godzina. Google użyje go do obliczenia opóźnienia.
  • Samolot już odszedł od bramki. Google użyje tego pola, aby poinformować użytkownika, kiedy samolot rzeczywiście odleciał.

Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia. Godzinę można określić z dokładnością do milisekundy.

np. 2027-03-05T06:30:00

Powinna to być lokalna data i godzina na lotnisku (a nie czas UTC).

Jeśli jest podane przesunięcie względem czasu UTC, Google odrzuci tę prośbę. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska wylotu.

Jeśli ta wartość nie będzie ustawiona, Google ustawi ją na podstawie danych z innych źródeł.

localBoardingDateTime

string

Godzina wejścia na pokład do wydrukowania na karcie pokładowej.

Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia. Godzinę można określić z dokładnością do milisekundy.

np. 2027-03-05T06:30:00

Powinna to być lokalna data i godzina na lotnisku (a nie czas UTC).

Jeśli jest podane przesunięcie względem czasu UTC, Google odrzuci tę prośbę. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska wylotu.

Jeśli ta wartość nie będzie ustawiona, Google ustawi ją na podstawie danych z innych źródeł.

localScheduledArrivalDateTime

string

Planowana godzina dotarcia samolotu do bramki docelowej (a nie pasa startowego).

Uwaga: to pole nie powinno zmieniać się zbyt blisko godziny lotu. Do aktualizowania godzin odlotów (opóźnienia itp.) należy używać localEstimatedOrActualArrivalDateTime.

Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia. Godzinę można określić z dokładnością do milisekundy.

np. 2027-03-05T06:30:00

Powinna to być lokalna data i godzina na lotnisku (a nie czas UTC).

Jeśli jest podane przesunięcie względem czasu UTC, Google odrzuci tę prośbę. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska przylotu.

Jeśli ta wartość nie będzie ustawiona, Google ustawi ją na podstawie danych z innych źródeł.

localEstimatedOrActualArrivalDateTime

string

Szacowana godzina zamierzonego dotarcia samolotu do bramki docelowej (a nie pasa startowego) lub faktyczna godzina dotarcia do bramki.

To pole należy ustawić, jeśli spełniony jest co najmniej jeden z tych warunków:

  • Jest inna niż zaplanowana godzina. Google użyje go do obliczenia opóźnienia.
  • Samolot już dotarł do bramki. Google użyje tego pola, aby poinformować użytkownika, że samolot dotarł do bramki.

Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia. Godzinę można określić z dokładnością do milisekundy.

np. 2027-03-05T06:30:00

Powinna to być lokalna data i godzina na lotnisku (a nie czas UTC).

Jeśli jest podane przesunięcie względem czasu UTC, Google odrzuci tę prośbę. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska przylotu.

Jeśli ta wartość nie będzie ustawiona, Google ustawi ją na podstawie danych z innych źródeł.

flightHeader

object (FlightHeader)

To pole jest wymagane. Informacje o przewoźniku lotniczym i numerze lotu.

origin

object (AirportInfo)

To pole jest wymagane. Lotnisko odlotu.

destination

object (AirportInfo)

To pole jest wymagane. Lotnisko docelowe.

flightStatus

enum (FlightStatus)

Stan tego lotu.

Jeśli nie jest skonfigurowana, Google oblicza stan na podstawie danych z innych źródeł, takich jak FlightStats itp.

Uwaga: stan obliczony przez Google nie będzie zwracany w odpowiedziach interfejsu API.

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Zasady dotyczące wchodzenia na pokład i przydzielania miejsc. Poinformują one, które etykiety będą wyświetlane użytkownikom.

localGateClosingDateTime

string

Godzina zamknięcia bramki do wydrukowania na karcie pokładowej. Nie ustawiaj tego pola, jeśli nie chcesz drukować go na karcie pokładowej.

Jest to data i godzina w rozszerzonym formacie ISO 8601 bez przesunięcia. Godzinę można określić z dokładnością do milisekundy.

np. 2027-03-05T06:30:00

Powinna to być lokalna data i godzina na lotnisku (a nie czas UTC).

Jeśli jest podane przesunięcie względem czasu UTC, Google odrzuci tę prośbę. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska wylotu.

classTemplateInfo

object (ClassTemplateInfo)

Informacje o szablonie wyświetlania klasy. Jeśli nie są ustawione, Google użyje domyślnego zestawu pól do wyświetlenia.

languageOverride

string

Jeśli to pole jest obecne, karty pokładowe udostępniane na urządzeniu użytkownika będą zawsze wyświetlane w tym języku. Reprezentuje tag języka BCP 47. Przykładowe wartości to „en-US”, „en-GB”, „de” i „de-AT”.

id

string

To pole jest wymagane. Unikalny identyfikator klasy. Ten identyfikator musi być unikalny wśród wszystkich klas wydawcy. Ta wartość powinna mieć format issuer ID.identifier, gdzie pierwszy identyfikator jest wystawiany przez Google, a drugi jest wybierany przez Ciebie. Unikalny identyfikator powinien zawierać tylko znaki alfanumeryczne oraz znaki „.”, „_” lub „-”.

version
(deprecated)

string (int64 format)

Wycofano

issuerName

string

To pole jest wymagane. Nazwa wydawcy. Zalecana maksymalna długość to 20 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.

messages[]

object (Message)

Tablica komunikatów wyświetlanych w aplikacji. Wszyscy użytkownicy tego obiektu będą otrzymywać powiązane z nim komunikaty. Maksymalna liczba tych pól to 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Rola wycofana. Użyj w zamian zasady multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

Identyfikator URI strony głównej aplikacji. Wypełnienie identyfikatora URI ma taki sam efekt jak wypełnienie identyfikatora URI w linksModuleData (przy renderowaniu obiektu link do strony głównej jest widoczny w miejscu, które można zwykle określić jako sekcję linksModuleData obiektu).

locations[]

object (LatLongPoint)

Uwaga: to pole nie jest obecnie obsługiwane w przypadku wyświetlania powiadomień geograficznych.

reviewStatus

enum (ReviewStatus)

To pole jest wymagane. Stan zajęć. To pole można ustawić na draft lub underReview za pomocą wywołań interfejsu API insert, patch lub update. Po zmianie stanu weryfikacji z draft nie można go zmienić z powrotem na draft.

Należy zachować wartość draft, gdy klasa jest w trakcie opracowywania. Klasy draft nie można użyć do utworzenia żadnego obiektu.

Pole to należy ustawić na underReview, gdy klasa jest gotowa do użycia. Platforma automatycznie ustawi to pole na approved i będzie można go natychmiast używać do tworzenia lub migrowania obiektów.

Aktualizując klasę, która jest już w stanie approved, należy ustawiać to pole na underReview.

review

object (Review)

Komentarze do weryfikacji ustawione przez platformę, gdy klasa jest oznaczona jako approved lub rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

Rola wycofana. Zamiast tego użyj textModulesData.

imageModulesData[]

object (ImageModuleData)

Dane modułu obrazów. Maksymalna liczba wyświetlanych pól to 1 z poziomu obiektu i 1 dla poziomu obiektu klasy.

textModulesData[]

object (TextModuleData)

Dane modułu tekstowego. Jeśli dane modułu tekstowego są określone również w klasie, będą wyświetlane jedne i drugie. Maksymalna liczba wyświetlanych pól to 10 z obiektu i 10 z klasy.

redemptionIssuers[]

string (int64 format)

Określa, którzy wydawcy elementów promocyjnych mogą wykorzystać kartę za pomocą smart tap. Wydawca elementów promocyjnych jest identyfikowany po identyfikatorze wydawcy. Wydawca elementów promocyjnych musi mieć skonfigurowany co najmniej 1 klucz smart tap.

Aby karta obsługiwała smart tap, pola enableSmartTap i smartTapRedemptionLevel na poziomie obiektu też muszą być odpowiednio skonfigurowane.

countryCode

string

Kod kraju używany do wyświetlania kraju karty (gdy użytkownik nie znajduje się w tym kraju), a także do wyświetlania zlokalizowanej treści, gdy treść nie jest dostępna w języku użytkownika.

heroImage

object (Image)

Opcjonalny obraz banera wyświetlany z przodu karty. Jeśli jej nie ma, nic nie jest wyświetlane. Obraz wyświetla się w 100% szerokości.

wordMark
(deprecated)

object (Image)

Rola wycofana.

enableSmartTap

boolean

Określa, czy ta klasa obsługuje smart tap. Aby karta obsługiwała smart tap, pola redemptionIssuers i smartTapRedemptionLevel na poziomie obiektu też muszą być odpowiednio skonfigurowane.

hexBackgroundColor

string

Kolor tła karty. Jeśli nie jest ustawiony, używany jest dominujący kolor obrazu banera powitalnego, a jeśli baner nie jest ustawiony, używany jest dominujący kolor logo. Format to #rrggbb, gdzie rrggbb to szesnastkowy zapis RGB, taki jak #ffcc00. Możesz także używać skróconej wersji zapisu RGB w formacie #rgb, jak w tym przypadku #fc0.

localizedIssuerName

object (LocalizedString)

Przetłumaczony tekst pola publisherName. Zalecana maksymalna długość to 20 znaków, aby zapewnić możliwość wyświetlania pełnego ciągu znaków na mniejszych ekranach.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Wskazuje, czy wielu użytkowników i urządzeń zapisze ten sam obiekt odwołujący się do tej klasy.

callbackOptions

object (CallbackOptions)

Opcje wywołania zwrotnego, które mają być używane do wywoływania wydawcy przy każdym zapisaniu/usunięciu obiektu tej klasy przez użytkownika końcowego. Wszystkie obiekty tej klasy kwalifikują się do wywołania zwrotnego.

securityAnimation

object (SecurityAnimation)

Opcjonalne informacje o animacji zabezpieczeń. Jeśli ta zasada jest skonfigurowana, w szczegółach karty będzie renderowana animacja dotycząca bezpieczeństwa.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Wyświetl opcje wymagania odblokowania dla karty pokładowej.

FlightHeader

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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#flightHeader".

carrier

object (FlightCarrier)

Informacje o przewoźniku lotniczym. Jest to wymagana właściwość flightHeader.

flightNumber

string

Numer lotu bez kodu IATA przewoźnika. To pole powinno zawierać tylko cyfry. Jest to wymagana właściwość flightHeader.

Na przykład: „123”.

operatingCarrier

object (FlightCarrier)

Informacje o przewoźniku lotniczym obsługującym lot.

operatingFlightNumber

string

Numer lotu używany przez przewoźnika obsługującego lot bez kodu IATA przewoźnika. To pole powinno zawierać tylko cyfry.

Na przykład: „234”.

flightNumberDisplayOverride

string

Zastąp wartość, która będzie używana w numerze lotu. Wartość domyślna używana do wyświetlania to operator + numer lotu. Jeśli musisz wyświetlić pasażerom inną wartość, użyj tego pola, aby zastąpić działanie domyślne.

Na przykład: „XX1234 / YY576”

FlightCarrier

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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#flightCarrier".

carrierIataCode

string

Dwuznakowy kod IATA linii lotniczej przewoźnika marketingowego (w przeciwieństwie do przewoźnika obsługującego lot). Ten kod albo carrierIcaoCode należy podać w przypadku carrier i operatingCarrier.

Na przykład: „LX” w przypadku linii Swiss Air.

carrierIcaoCode

string

Trzyznakowy kod linii lotniczej ICAO przewoźnika marketingowego (w przeciwieństwie do przewoźnika obsługującego lot). Ten kod albo carrierIataCode należy podać w przypadku carrier i operatingCarrier.

Na przykład: „EZY” w przypadku linii Easy Jet.

airlineName

object (LocalizedString)

Zlokalizowana nazwa linii lotniczej określona przez operatorIataCode. Jeśli nie jest skonfigurowana, do wyświetlania będzie używana wartość issuerName lub localizedIssuerName z FlightClass.

Na przykład: „Swiss Air” w przypadku „LX”.

AirportInfo

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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#airportInfo".

airportIataCode

string

Trzyznakowy kod IATA lotniska. To pole jest wymagane w przypadku origin i destination.

Na przykład: „SFO”.

terminal

string

Nazwa terminala. Na przykład: „INTL” lub „I”.

gate

string

Nazwa bramki. Na przykład: „B59” lub „59”

airportNameOverride

object (LocalizedString)

Pole opcjonalne, które zastępuje nazwę miasta lotniska zdefiniowaną przez IATA. Domyślnie Google pobiera dane airportIataCode i mapuje je na oficjalną nazwę miasta, w którym znajduje się lotnisko, zdefiniowaną przez IATA.

Oficjalne nazwy miast lotniska IATA można znaleźć na stronie nazwy miast lotnisk IATA. Na przykład w przypadku kodu IATA lotniska „LTN” na stronie internetowej IATA znajduje się informacja, że odpowiednim miastem lotniska jest „Londyn”.

Jeśli to pole nie zostanie wypełnione, Google wyświetli „Londyn”.

Wypełnienie tego pola niestandardową nazwą (np. „London Luton”) spowoduje, że ta nazwa zostanie zastąpiona.

FlightStatus

Wartości w polu enum
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED Lot jest na czas, przed czasem lub opóźniony.
scheduled

Starsza wersja aliasu dla SCHEDULED. Rola wycofana.

ACTIVE Lot trwa (kołowanie, start, lądowanie, samolot powietrzny).
active

Starsza wersja aliasu dla ACTIVE. Rola wycofana.

LANDED Samolot wylądował w pierwotnym miejscu docelowym.
landed

Starsza wersja aliasu dla LANDED. Rola wycofana.

CANCELLED Lot został odwołany.
cancelled

Starsza wersja aliasu dla CANCELLED. Rola wycofana.

REDIRECTED Samolot jest w powietrzu, ale kieruje na lotnisko inne niż pierwotne miejsce docelowe.
redirected

Starsza wersja aliasu dla REDIRECTED. Rola wycofana.

DIVERTED Samolot wylądował już na innym lotnisku niż pierwotne miejsce docelowe.
diverted

Starsza wersja aliasu dla DIVERTED. Rola wycofana.

BoardingAndSeatingPolicy

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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "walletobjects#boardingAndSeatingPolicy".

boardingPolicy

enum (BoardingPolicy)

Wskazuje zasady stosowane przez linię lotniczą podczas wchodzenia na pokład. Jeśli nie są ustawione, Google przyjmuje domyślnie zoneBased.

seatClassPolicy

enum (SeatClassPolicy)

Zasady dotyczące miejsc, które określają, w jaki sposób wyświetlamy klasę miejsc. Jeśli nie są ustawione, Google przyjmuje domyślnie cabinBased.

BoardingPolicy

Wartości w polu enum
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

Starsza wersja aliasu dla ZONE_BASED. Rola wycofana.

GROUP_BASED
groupBased

Starsza wersja aliasu dla GROUP_BASED. Rola wycofana.

BOARDING_POLICY_OTHER
boardingPolicyOther

Starsza wersja aliasu dla BOARDING_POLICY_OTHER. Rola wycofana.

SeatClassPolicy

Wartości w polu enum
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

Starsza wersja aliasu dla CABIN_BASED. Rola wycofana.

CLASS_BASED
classBased

Starsza wersja aliasu dla CLASS_BASED. Rola wycofana.

TIER_BASED
tierBased

Starsza wersja aliasu dla TIER_BASED. Rola wycofana.

SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

Starsza wersja aliasu dla SEAT_CLASS_POLICY_OTHER. Rola wycofana.

Metody

addmessage

Dodaje komunikat do klasy lotu, do której odwołuje się podany identyfikator klasy.

get

Zwraca klasę lotu o podanym identyfikatorze klasy.

insert

Wstawia klasę lotu o podanym identyfikatorze i właściwościach.

list

Zwraca listę wszystkich klas lotu dla podanego identyfikatora wydawcy.

patch

Aktualizuje klasę lotu, do której odwołuje się podany identyfikator klasy.

update

Aktualizuje klasę lotu, do której odwołuje się podany identyfikator klasy.