REST Resource: flightclass

資源：FlightClass

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)
}
欄位
kind
(deprecated)

string

識別資源的種類。值：固定字串 "walletobjects#flightClass"。
localScheduledDepartureDateTime

string

必要欄位。飛機離開登機門 (而非跑道) 的表定日期和時間

注意：這個欄位不應過於接近出發時間。如要更新起飛時間 (例如發生延遲情況)，請設定 localEstimatedOrActualDepartureDateTime。

日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。

例如：2027-03-05T06:30:00

這是機場的當地日期/時間 (並非世界標準時間)。

如果提供世界標準時間偏移值，Google 將拒絕這項要求。Google 會根據出發機場計算時區。
localEstimatedOrActualDepartureDateTime

string

飛機離開登機門的預計時間，或飛機實際從登機門離開的時間。注意：這個值並非跑道時間。

如果符合下列其中一項條件，請設定這個欄位：

  • 時間與表定時間不同。Google 會使用這個值來計算延誤時間。
  • 飛機已離開登機門。航班實際起飛時，Google 會使用這個值來通知使用者。

日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。

例如：2027-03-05T06:30:00

這是機場的當地日期/時間 (並非世界標準時間)。

如果提供世界標準時間偏移值，Google 將拒絕這項要求。Google 會根據出發機場計算時區。

如未設定，Google 會根據其他來源的資料進行設定。
localBoardingDateTime

string

登機證上列出的登機時間。

日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。

例如：2027-03-05T06:30:00

這是機場的當地日期/時間 (並非世界標準時間)。

如果提供世界標準時間偏移值，Google 將拒絕這項要求。Google 會根據出發機場計算時區。

如未設定，Google 會根據其他來源的資料進行設定。
localScheduledArrivalDateTime

string

飛機抵達目的地登機門 (而非跑道) 的表定時間。

注意：這個欄位不應過於接近航班時間。如要更新起飛時間 (例如發生延遲情況)，請設定 localEstimatedOrActualArrivalDateTime。

日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。

例如：2027-03-05T06:30:00

這是機場的當地日期/時間 (並非世界標準時間)。

如果提供世界標準時間偏移值，Google 將拒絕這項要求。Google 會根據抵達機場計算時區。

如未設定，Google 會根據其他來源的資料進行設定。
localEstimatedOrActualArrivalDateTime

string

飛機抵達目的地登機門 (而非跑道) 的預計時間，或是抵達登機門的確切時間。

如果符合下列其中一項條件，請設定這個欄位：

  • 時間與表定時間不同。Google 會使用這個值來計算延誤時間。
  • 飛機已抵達登機門。Google 會使用這個值來通知使用者航班已抵達登機門。

日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。

例如：2027-03-05T06:30:00

這是機場的當地日期/時間 (並非世界標準時間)。

如果提供世界標準時間偏移值，Google 將拒絕這項要求。Google 會根據抵達機場計算時區。

如未設定，Google 會根據其他來源的資料進行設定。
flightHeader

object (FlightHeader)

必要欄位。航班航空公司和航班編號的相關資訊。
origin

object (AirportInfo)

必要欄位。出發地機場。
destination

object (AirportInfo)

必要欄位。目的地機場。
flightStatus

enum (FlightStatus)

這個航班的狀態。

如未設定，Google 會根據 FlightStats 等其他來源的資料計算狀態。

注意事項：API 回應中不會傳回 Google 決定的狀態值。
boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

登機和座位政策。這類規則會說明要向使用者顯示哪些標籤。
localGateClosingDateTime

string

登機證上列出的登機門關閉時間。如果不想在登機證上列印這個欄位，請勿設定這個欄位。

日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。

例如：2027-03-05T06:30:00

這是機場的當地日期/時間 (並非世界標準時間)。

如果提供世界標準時間偏移值，Google 將拒絕這項要求。Google 會根據出發機場計算時區。
classTemplateInfo

object (ClassTemplateInfo)

類別顯示方式的範本資訊。如未設定，Google 會改回顯示一組預設欄位。
languageOverride

string

如有這個欄位，提供給使用者裝置的登機證將一律採用此語言。代表 BCP 47 語言標記。範例值為「en-US」、「en-GB」、「de」或「de-AT」。
id

string

必要欄位。類別的專屬 ID。特定核發者的所有類別 ID 都不得重複。這個值應採用以下格式：issuer ID。identifier，其中前者是由 Google 核發，後者則您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。
version
(deprecated)

string (int64 format)

已淘汰
issuerName

string

必要欄位。核發者的名稱。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。
messages[]

object (Message)

應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限為 10 個。
allowMultipleUsersPerObject
(deprecated)

boolean

已淘汰，請改用 multipleDevicesAndHoldersAllowedStatus。
homepageUri

object (Uri)

應用程式首頁的 URI。在這個欄位填入 URI 會產生與在 linksModuleData 填入 URI 相同的行為 (轉譯物件時，首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。
locations[]

object (LatLongPoint)

注意：這個欄位目前不支援觸發地理通知。
reviewStatus

enum (ReviewStatus)

必要欄位。類別的狀態。可以透過 insert、patch 或更新 API 呼叫，將此欄位設為 draft 或 underReview。一旦審查狀態從 draft 變更為其他狀態，就無法再變回 draft。

當類別處於開發階段時，這個欄位應保留為 draft。draft 類別無法用於建立任何物件。

如果您確認類別可供使用，應將這個欄位設為 underReview。平台會自動將這個欄位設為 approved，這樣就能立即用於建立或遷移物件。

更新已處於 approved 的類別時，請繼續將這個欄位設為 underReview。
review

object (Review)

當類別標示為 approved 或 rejected 時，平台所設定的審查留言。
infoModuleData
(deprecated)

object (InfoModuleData)

已淘汰，請改用 textModulesData。
imageModulesData[]

object (ImageModuleData)

圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個，以及類別物件層級 1 個。
textModulesData[]

object (TextModuleData)

文字模組資料。如果類別中也定義了文字模組資料，則兩項資料都會顯示。這類欄位的顯示數量上限為物件中的 10 個，以及類別中的 10 個。
redemptionIssuers[]

string (int64 format)

找出哪些兌換核發機構可以透過智慧感應功能兌換票證。兌換核發機構由其核發機構 ID 識別。兌換核發機構必須設定至少一個智慧感應功能。

此外，您也必須正確設定 enableSmartTap 和物件層級的 smartTapRedemptionLevel 欄位，票證才能支援智慧感應功能。
countryCode

string

國家/地區代碼，用於顯示卡片的國家/地區 (當使用者不在該國家/地區時)，以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。
heroImage

object (Image)

顯示在資訊卡正面的選用橫幅圖片。如果沒有顯示任何項目，系統就不會顯示任何內容。圖片寬度為 100%。
wordMark
(deprecated)

object (Image)

已淘汰。
enableSmartTap

boolean

指出這個類別是否支援智慧感應功能。此外，您也必須正確設定 redemptionIssuers 和物件層級的 smartTapRedemptionLevel 欄位，票證才能支援智慧感應功能。
hexBackgroundColor

string

資訊卡的背景顏色。如果未設定，將會使用主頁橫幅的主要顏色；如果未設定主頁橫幅，則會使用標誌的主要顏色。格式為 #rrggbb，其中 rrggbb 是十六進位的 RGB 三元組，例如 #ffcc00。您也可以使用 RGB 三元組的簡寫版本 #rgb，例如 #fc0。
localizedIssuerName

object (LocalizedString)

cardName 的翻譯字串。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。
multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

指出是否有多位使用者和多台裝置會儲存參照這個類別的同一個物件。
callbackOptions

object (CallbackOptions)

使用者每次儲存/刪除這個類別的物件時，都可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼。
securityAnimation

object (SecurityAnimation)

關於安全性動畫的選擇性資訊。如果設定了這項政策，票證詳細資料就會顯示安全性動畫。
viewUnlockRequirement

enum (ViewUnlockRequirement)

查看登機證的解鎖規定選項。

FlightHeader

JSON 表示法 
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
欄位
kind
(deprecated)

string

識別資源的種類。值：固定字串 "walletobjects#flightHeader"。
carrier

object (FlightCarrier)

航空公司的相關資訊。這是 flightHeader 的必填屬性。
flightNumber

string

航班編號 (不含 IATA 航空公司代碼)。這個欄位只能包含數字。這是 flightHeader 的必填屬性。

例如：「123」
operatingCarrier

object (FlightCarrier)

營運航空公司的相關資訊。
operatingFlightNumber

string

營運航空公司使用的航班編號 (不含 IATA 航空公司代碼)。這個欄位只能包含數字。

例如：「234」
flightNumberDisplayOverride

string

覆寫要用於航班號碼的值。用於顯示內容的預設值是航空公司 +flightNumber。如需向乘客顯示其他值，請使用這個欄位覆寫預設行為。

例如：「XX1234 / YY576」

FlightCarrier

JSON 表示法 
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
欄位
kind
(deprecated)

string

識別資源的種類。值：固定字串 "walletobjects#flightCarrier"。
carrierIataCode

string

行銷航空公司 (相對於承運航空公司) 的 IATA 航空公司代碼 (共兩個字元)。必須提供一個此種代碼或 carrierIcaoCode 給 carrier 和 operatingCarrier。

例如：瑞士國際航空公司的代碼為「LX」
carrierIcaoCode

string

行銷航空公司 (相對於承運航空公司) 的 ICAO 航空公司代碼 (共 3 個字元)。必須提供一個此種代碼或 carrierIataCode 給 carrier 和 operatingCarrier。

例如：「EZY」代表簡易噴射機
airlineName

object (LocalizedString)

由 CarrierIataCode 指定的航空公司本地化名稱。如未設定，則會顯示 FlightClass 的 issuerName 或 localizedIssuerName。

例如：瑞士國際航空公司的代碼為「LX」

AirportInfo

JSON 表示法 
{
  "kind": string,
  "airportIataCode": string,
  "terminal": string,
  "gate": string,
  "airportNameOverride": {
    object (LocalizedString)
  }
}
欄位
kind
(deprecated)

string

識別資源的種類。值：固定字串 "walletobjects#airportInfo"。
airportIataCode

string

IATA 機場代碼 (共 3 個字元)。這是 origin 和 destination 的必填欄位。

例如：「SFO」
terminal

string

航站名稱。例如：「INTL」或「I」
gate

string

登機門名稱，例如：「B59」或「59」
airportNameOverride

object (LocalizedString)

這個選填欄位會覆寫由 IATA 定義的機場城市名稱。根據預設，Google 會採用提供的 airportIataCode，並將其對應至 IATA 定義的官方機場城市名稱。

IATA 機場城市名稱網站列出了 IATA 的官方機場城市名稱。以 IATA 代碼「LTN」為例，IATA 網站顯示的相應機場城市為「倫敦」。

如果不填入這個欄位，Google 會顯示「倫敦」。

不過，在這個欄位填入自訂名稱 (例如：「倫敦 Luton」) 將覆寫這個值。

FlightStatus

列舉
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED 航班會準時、提早或誤點。
scheduled

SCHEDULED 的舊版別名，已淘汰。
ACTIVE 航班正在途中 (滑行、起飛、降落、飛行)。
active

ACTIVE 的舊版別名，已淘汰。
LANDED 航班已在原始目的地降落。
landed

LANDED 的舊版別名，已淘汰。
CANCELLED 航班已取消。
cancelled

CANCELLED 的舊版別名，已淘汰。
REDIRECTED 航班正在飛行中，但前往的機場與原始目的地不同。
redirected

REDIRECTED 的舊版別名，已淘汰。
DIVERTED 航班已於與原始目的地不同的機場降落。
diverted

DIVERTED 的舊版別名，已淘汰。

BoardingAndSeatingPolicy

JSON 表示法 
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
欄位
kind
(deprecated)

string

識別資源的種類。值：固定字串 "walletobjects#boardingAndSeatingPolicy"。
boardingPolicy

enum (BoardingPolicy)

指出航空公司的登機政策。如未設定，Google 會預設為 zoneBased。
seatClassPolicy

enum (SeatClassPolicy)

座位政策會影響系統顯示座位級別的方式。如未設定，Google 會預設為 cabinBased。

BoardingPolicy

列舉
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

ZONE_BASED 的舊版別名，已淘汰。
GROUP_BASED
groupBased

GROUP_BASED 的舊版別名，已淘汰。
BOARDING_POLICY_OTHER
boardingPolicyOther

BOARDING_POLICY_OTHER 的舊版別名，已淘汰。

SeatClassPolicy

列舉
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

CABIN_BASED 的舊版別名，已淘汰。
CLASS_BASED
classBased

CLASS_BASED 的舊版別名，已淘汰。
TIER_BASED
tierBased

TIER_BASED 的舊版別名，已淘汰。
SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

SEAT_CLASS_POLICY_OTHER 的舊版別名，已淘汰。

方法

addmessage

 在指定類別 ID 參照的航班類別中新增訊息。

get

 傳回含有指定類別 ID 的航班類別。

insert

 插入具有指定 ID 和屬性的航班類別。

list

 傳回指定核發者 ID 的所有航班類別清單。

patch

 更新指定類別 ID 參照的航班類別。

update

 更新指定類別 ID 參照的航班類別。