資源:FlightClass
JSON 表示法 |
---|
{ "kind": string, "localScheduledDepartureDateTime": string, "localEstimatedOrActualDepartureDateTime": string, "localBoardingDateTime": string, "localScheduledArrivalDateTime": string, "localEstimatedOrActualArrivalDateTime": string, "flightHeader": { object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
localScheduledDepartureDateTime |
必要欄位。飛機離開登機門 (而非跑道) 的表定日期和時間 注意:這個欄位不應過於接近出發時間。如要更新起飛時間 (例如發生延遲情況),請設定 日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。 例如: 這是機場的當地日期/時間 (並非世界標準時間)。 如果提供世界標準時間偏移值,Google 將拒絕這項要求。Google 會根據出發機場計算時區。 |
localEstimatedOrActualDepartureDateTime |
飛機離開登機門的預計時間,或飛機實際從登機門離開的時間。注意:這個值並非跑道時間。 如果符合下列其中一項條件,請設定這個欄位:
日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。 例如: 這是機場的當地日期/時間 (並非世界標準時間)。 如果提供世界標準時間偏移值,Google 將拒絕這項要求。Google 會根據出發機場計算時區。 如未設定,Google 會根據其他來源的資料進行設定。 |
localBoardingDateTime |
登機證上列出的登機時間。 日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。 例如: 這是機場的當地日期/時間 (並非世界標準時間)。 如果提供世界標準時間偏移值,Google 將拒絕這項要求。Google 會根據出發機場計算時區。 如未設定,Google 會根據其他來源的資料進行設定。 |
localScheduledArrivalDateTime |
飛機抵達目的地登機門 (而非跑道) 的表定時間。 注意:這個欄位不應過於接近航班時間。如要更新起飛時間 (例如發生延遲情況),請設定 日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。 例如: 這是機場的當地日期/時間 (並非世界標準時間)。 如果提供世界標準時間偏移值,Google 將拒絕這項要求。Google 會根據抵達機場計算時區。 如未設定,Google 會根據其他來源的資料進行設定。 |
localEstimatedOrActualArrivalDateTime |
飛機抵達目的地登機門 (而非跑道) 的預計時間,或是抵達登機門的確切時間。 如果符合下列其中一項條件,請設定這個欄位:
日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。 例如: 這是機場的當地日期/時間 (並非世界標準時間)。 如果提供世界標準時間偏移值,Google 將拒絕這項要求。Google 會根據抵達機場計算時區。 如未設定,Google 會根據其他來源的資料進行設定。 |
flightHeader |
必要欄位。航班航空公司和航班編號的相關資訊。 |
origin |
必要欄位。出發地機場。 |
destination |
必要欄位。目的地機場。 |
flightStatus |
這個航班的狀態。 如未設定,Google 會根據 FlightStats 等其他來源的資料計算狀態。 注意事項:API 回應中不會傳回 Google 決定的狀態值。 |
boardingAndSeatingPolicy |
登機和座位政策。這類規則會說明要向使用者顯示哪些標籤。 |
localGateClosingDateTime |
登機證上列出的登機門關閉時間。如果不想在登機證上列印這個欄位,請勿設定這個欄位。 日期/時間採用 ISO 8601 擴充格式 (不含偏移量)。時間可以指定到毫秒精確度。 例如: 這是機場的當地日期/時間 (並非世界標準時間)。 如果提供世界標準時間偏移值,Google 將拒絕這項要求。Google 會根據出發機場計算時區。 |
classTemplateInfo |
類別顯示方式的範本資訊。如未設定,Google 會改回顯示一組預設欄位。 |
languageOverride |
如有這個欄位,提供給使用者裝置的登機證將一律採用此語言。代表 BCP 47 語言標記。範例值為「en-US」、「en-GB」、「de」或「de-AT」。 |
id |
必要欄位。類別的專屬 ID。特定核發者的所有類別 ID 都不得重複。這個值應採用以下格式:issuer ID。identifier,其中前者是由 Google 核發,後者則您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
version |
已淘汰 |
issuerName |
必要欄位。核發者的名稱。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
messages[] |
應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限為 10 個。 |
allowMultipleUsersPerObject |
已淘汰,請改用 |
homepageUri |
應用程式首頁的 URI。在這個欄位填入 URI 會產生與在 linksModuleData 填入 URI 相同的行為 (轉譯物件時,首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。 |
locations[] |
注意:這個欄位目前不支援觸發地理通知。 |
reviewStatus |
必要欄位。類別的狀態。可以透過 insert、patch 或更新 API 呼叫,將此欄位設為 當類別處於開發階段時,這個欄位應保留為 如果您確認類別可供使用,應將這個欄位設為 更新已處於 |
review |
當類別標示為 |
infoModuleData |
已淘汰,請改用 textModulesData。 |
imageModulesData[] |
圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個,以及類別物件層級 1 個。 |
textModulesData[] |
文字模組資料。如果類別中也定義了文字模組資料,則兩項資料都會顯示。這類欄位的顯示數量上限為物件中的 10 個,以及類別中的 10 個。 |
linksModuleData |
連結模組資料。如果物件中也定義了連結模組資料,則兩項資料都會顯示。 |
redemptionIssuers[] |
找出哪些兌換核發機構可以透過智慧感應功能兌換票證。兌換核發機構由其核發機構 ID 識別。兌換核發機構必須設定至少一個智慧感應功能。 此外,您也必須正確設定 |
countryCode |
國家/地區代碼,用於顯示卡片的國家/地區 (當使用者不在該國家/地區時),以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。 |
heroImage |
顯示在資訊卡正面的選用橫幅圖片。如果沒有顯示任何項目,系統就不會顯示任何內容。圖片寬度為 100%。 |
wordMark |
已淘汰。 |
enableSmartTap |
指出這個類別是否支援智慧感應功能。此外,您也必須正確設定 |
hexBackgroundColor |
資訊卡的背景顏色。如果未設定,將會使用主頁橫幅的主要顏色;如果未設定主頁橫幅,則會使用標誌的主要顏色。格式為 #rrggbb,其中 rrggbb 是十六進位的 RGB 三元組,例如 |
localizedIssuerName |
cardName 的翻譯字串。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
multipleDevicesAndHoldersAllowedStatus |
指出是否有多位使用者和多台裝置會儲存參照這個類別的同一個物件。 |
callbackOptions |
使用者每次儲存/刪除這個類別的物件時,都可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼。 |
securityAnimation |
關於安全性動畫的選擇性資訊。如果設定了這項政策,票證詳細資料就會顯示安全性動畫。 |
viewUnlockRequirement |
查看登機證的解鎖規定選項。 |
FlightHeader
JSON 表示法 |
---|
{ "kind": string, "carrier": { object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
carrier |
航空公司的相關資訊。這是 |
flightNumber |
航班編號 (不含 IATA 航空公司代碼)。這個欄位只能包含數字。這是 例如:「123」 |
operatingCarrier |
營運航空公司的相關資訊。 |
operatingFlightNumber |
營運航空公司使用的航班編號 (不含 IATA 航空公司代碼)。這個欄位只能包含數字。 例如:「234」 |
flightNumberDisplayOverride |
覆寫要用於航班號碼的值。用於顯示內容的預設值是航空公司 +flightNumber。如需向乘客顯示其他值,請使用這個欄位覆寫預設行為。 例如:「XX1234 / YY576」 |
FlightCarrier
JSON 表示法 |
---|
{ "kind": string, "carrierIataCode": string, "carrierIcaoCode": string, "airlineName": { object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
carrierIataCode |
行銷航空公司 (相對於承運航空公司) 的 IATA 航空公司代碼 (共兩個字元)。必須提供一個此種代碼或 例如:瑞士國際航空公司的代碼為「LX」 |
carrierIcaoCode |
行銷航空公司 (相對於承運航空公司) 的 ICAO 航空公司代碼 (共 3 個字元)。必須提供一個此種代碼或 例如:「EZY」代表簡易噴射機 |
airlineName |
由 CarrierIataCode 指定的航空公司本地化名稱。如未設定,則會顯示 例如:瑞士國際航空公司的代碼為「LX」 |
airlineLogo |
由 CarrierIataCode 和 localizedAirlineName 描述的航空公司標誌。這個標誌會顯示在詳細資訊卡檢視畫面頂端。 |
airlineAllianceLogo |
航空公司聯盟的標誌,顯示在乘客登機時掃描的 QR code 下方。 |
wideAirlineLogo |
航空公司的寬標誌。提供這項資訊會用來取代資訊卡檢視左上方的航空公司標誌。 |
AirportInfo
JSON 表示法 |
---|
{
"kind": string,
"airportIataCode": string,
"terminal": string,
"gate": string,
"airportNameOverride": {
object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
airportIataCode |
IATA 機場代碼 (共 3 個字元)。這是 例如:「SFO」 |
terminal |
航站名稱。例如:「INTL」或「I」 |
gate |
登機門名稱,例如:「B59」或「59」 |
airportNameOverride |
這個選填欄位會覆寫由 IATA 定義的機場城市名稱。根據預設,Google 會採用提供的 IATA 機場城市名稱網站列出了 IATA 的官方機場城市名稱。以 IATA 代碼「LTN」為例,IATA 網站顯示的相應機場城市為「倫敦」。 如果不填入這個欄位,Google 會顯示「倫敦」。 不過,在這個欄位填入自訂名稱 (例如:「倫敦 Luton」) 將覆寫這個值。 |
FlightStatus
列舉 | |
---|---|
FLIGHT_STATUS_UNSPECIFIED |
|
SCHEDULED |
航班會準時、提早或誤點。 |
scheduled |
|
ACTIVE |
航班正在途中 (滑行、起飛、降落、飛行)。 |
active |
|
LANDED |
航班已在原始目的地降落。 |
landed |
|
CANCELLED |
航班已取消。 |
cancelled |
|
REDIRECTED |
航班正在飛行中,但前往的機場與原始目的地不同。 |
redirected |
|
DIVERTED |
航班已於與原始目的地不同的機場降落。 |
diverted |
|
BoardingAndSeatingPolicy
JSON 表示法 |
---|
{ "kind": string, "boardingPolicy": enum ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
boardingPolicy |
指出航空公司的登機政策。如未設定,Google 會預設為 |
seatClassPolicy |
座位政策會影響系統顯示座位級別的方式。如未設定,Google 會預設為 |
BoardingPolicy
列舉 | |
---|---|
BOARDING_POLICY_UNSPECIFIED |
|
ZONE_BASED |
|
zoneBased |
|
GROUP_BASED |
|
groupBased |
|
BOARDING_POLICY_OTHER |
|
boardingPolicyOther |
|
SeatClassPolicy
列舉 | |
---|---|
SEAT_CLASS_POLICY_UNSPECIFIED |
|
CABIN_BASED |
|
cabinBased |
|
CLASS_BASED |
|
classBased |
|
TIER_BASED |
|
tierBased |
|
SEAT_CLASS_POLICY_OTHER |
|
seatClassPolicyOther |
|
方法 |
|
---|---|
|
在指定類別 ID 參照的航班類別中新增訊息。 |
|
傳回含有指定類別 ID 的航班類別。 |
|
插入具有指定 ID 和屬性的航班類別。 |
|
傳回指定核發者 ID 的所有航班類別清單。 |
|
更新指定類別 ID 參照的航班類別。 |
|
更新指定類別 ID 參照的航班類別。 |