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),
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Pola
kind
(deprecated)

string

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

localScheduledDepartureDateTime

string

Wymagane. Planowana data i godzina odejścia samolotu od bramki (ale nie opuszczenia 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.

Są 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

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

Google odrzuci żądanie, jeżeli zostanie podane przesunięcie UTC. Strefy czasowe będą obliczane przez Google na podstawie lotniska odlotu.

localEstimatedOrActualDepartureDateTime

string

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

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

  • Ta godzina różni się od planowanej godziny rozpoczęcia. Google użyje tego pola do obliczenia opóźnienia.
  • Samolot już odszedł od bramki. Google użyje tego pola, aby poinformować użytkownika, kiedy samolot rzeczywiście odleciał.

Są 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

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

Google odrzuci prośbę, jeśli podasz przesunięcie UTC. Strefy czasowe będą obliczane przez Google na podstawie lotniska odlotu.

localBoardingDateTime

string

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

Są 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

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

Google odrzuci żądanie, jeżeli zostanie podane przesunięcie UTC. Strefy czasowe będą obliczane przez Google na podstawie lotniska odlotu.

localScheduledArrivalDateTime

string

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

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

Są 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

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

Google odrzuci żądanie, jeżeli zostanie podane przesunięcie UTC. Strefy czasowe zostaną obliczone przez Google na podstawie lotniska przylotu.

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 przynajmniej jeden z poniższych warunków:

  • Ta godzina różni się od planowanej godziny przylotu. Google użyje tego pola do obliczenia opóźnienia.
  • Samolot już dotarł do bramki. Google użyje tego pola, aby poinformować użytkownika, że samolot dotarł do bramki.

Są 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

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

Google odrzuci żądanie, jeżeli zostanie podane przesunięcie UTC. Strefy czasowe będą obliczane przez Google na podstawie lotniska przylotu.

flightHeader

object (FlightHeader)

Wymagane. Informacje o przewoźniku lotniczym i numerze lotu.

origin

object (AirportInfo)

Wymagane. Lotnisko odlotu.

destination

object (AirportInfo)

Wymagane. Lotnisko docelowe.

flightStatus

enum (FlightStatus)

Stan tego lotu.

Jeśli nie zostanie ustawiony, Google wyznaczy stan na podstawie danych z innych źródeł, takich jak FlightStats itp.

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

boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Zasady dotyczące wchodzenia na pokład i przydziału 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 należy ustawiać tego pola, jeśli nie jest planowane jego drukowanie na karcie pokładowej.

Są 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

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

Google odrzuci żądanie, jeżeli zostanie podane przesunięcie UTC. Strefy czasowe będą obliczane przez Google na podstawie lotniska odlotu.

classTemplateInfo

object (ClassTemplateInfo)

Informacje na temat szablonu wyświetlania klasy. Jeśli nie są ustawione, Google przyjmuje domyślny zestaw 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” lub „de-AT”.

id

string

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

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. Zamiast tego użyj pola multipleDevicesAndHoldersAllowedStatus.

homepageUri

object (Uri)

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

locations[]
(deprecated)

object (LatLongPoint)

Uwaga: to pole nie jest obecnie obsługiwane w przypadku wywoływania powiadomień geograficznych.

reviewStatus

enum (ReviewStatus)

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

Należy zachować stan draft, gdy klasa jest w fazie rozwoju. Klasy w stanie draft nie można użyć do utworzenia żadnego obiektu.

Ustaw to pole na underReview, gdy uznasz, że 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 obrazu. Maksymalna liczba wyświetlanych pól wynosi 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 wynosi 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. Wydawcy elementów promocyjnych są identyfikowani na podstawie identyfikatora wydawcy. Wydawcy ofert muszą mieć skonfigurowany co najmniej 1 klucz Smart Tap.

Aby karta obsługiwała funkcję Smart Tap, pola enableSmartTap i smartTapRedemptionLevel na poziomie obiektu muszą być też prawidłowo skonfigurowane.

countryCode

string

Kod kraju używany do wyświetlania kraju karty (gdy użytkownik nie jest w tym kraju) oraz 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 go nie ma, nic nie jest wyświetlane. Obraz wyświetla się w 100% szerokości.

wordMark
(deprecated)

object (Image)

Rola wycofana.

enableSmartTap

boolean

Wskazuje, czy ta klasa obsługuje smart tap. Aby karta obsługiwała funkcję Smart Tap, pola redemptionIssuers i smartTapRedemptionLevel na poziomie obiektu muszą być też prawidłowo skonfigurowane.

hexBackgroundColor

string

Kolor tła karty. Jeśli nie jest ustawiony, używany jest dominujący kolor banera powitalnego, a jeśli 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 przykładzie: #fc0.

localizedIssuerName

object (LocalizedString)

Przetłumaczona wartość pola issuerName. 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 zapisie/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 dotyczącej bezpieczeństwa. Jeśli ta opcja jest ustawiona, animacja bezpieczeństwa zostanie wyświetlona w szczegółach dokumentu.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Wyświetl opcje wymagające odblokowania karty pokładowej.

notifyPreference

enum (NotificationSettingsForUpdates)

Określa, czy powiadomienia mają być wysyłane w przypadku aktualizacji pól w danej klasie. Gdy ustawisz opcję NOTIFY (powiadamiaj), spróbujemy wywołać powiadomienie o zmianie pola dla użytkowników. Te powiadomienia będą wysyłane tylko do użytkowników, jeśli pole jest częścią listy dozwolonych. Jeśli nie określisz tej wartości, nie zostanie wysłane żadne powiadomienie. To ustawienie jest tymczasowe i musi być ustawiane w ramach każdego żądania PATCH lub UPDATE, w przeciwnym razie powiadomienie nie zostanie wywołane.

valueAddedModuleData[]

object (ValueAddedModuleData)

Opcjonalne dane modułu wartości dodanej. Maksymalnie 10 na zajęcia. W przypadku karty wyświetlanych będzie tylko 10 wyświetleń, priorytetowe będą te z obiektu.

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

Wartość zastępcza do użycia w przypadku numeru lotu. Wartością domyślną w przypadku wyświetlania jest operator + flightNumber. Jeśli pasażerowie mają zobaczyć inną wartość, użyj tego pola, aby zastąpić domyślne zachowanie.

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 firmującego lot (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 ICAO linii lotniczej przewoźnika firmującego lot (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 carrierIataCode. Jeśli nie jest ustawiona, do wyświetlania będzie używana wartość issuerName lub localizedIssuerName z FlightClass.

Na przykład: „Swiss Air” w przypadku kodu „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 airportIataCode i mapuje na oficjalną nazwę miasta lotniska zdefiniowaną przez IATA.

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

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

Jednak wypełnienie tego pola niestandardową nazwą (np. „London Luton”) spowoduje, że ta właśnie nazwa będzie wyświetlana.

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, w powietrzu).
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 się 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 linie lotnicze przy wchodzeniu na pokład. Jeśli nie są ustawione, Google przyjmuje domyślnie zoneBased.

seatClassPolicy

enum (SeatClassPolicy)

Zasady dotyczące przydziału miejsc, które determinują sposób wyświetlania klasy 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.