REST Resource: flightclass

{
  "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),
  "appLinkData": {
    object (AppLinkData)
  }
}

string

標示資源的種類。值：固定字串 "walletobjects#flightClass"。

string

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

注意：這個欄位不應過於接近出發時間。如須更新起飛時間 (例如誤點)，請設定 localEstimatedOrActualDepartureDateTime。

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

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

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

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

string

飛機離開登機門的預計時間，或是飛機實際從登機門離開的時間。請注意：這個值與跑道時間不同。

如果符合以下其中一項條件，就必須設定這個欄位：

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

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

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

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

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

string

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

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

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

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

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

string

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

注意：這個欄位不應過於接近航班時間。如須更新起飛時間 (例如誤點)，請設定 localEstimatedOrActualArrivalDateTime。

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

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

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

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

string

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

如果符合以下其中一項條件，就必須設定這個欄位：

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

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

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

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

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

object (FlightHeader)

必要欄位。航班所屬航空公司和號碼的相關資訊。

object (AirportInfo)

必要欄位。出發地機場。

object (AirportInfo)

必要欄位。目的地機場。

enum (FlightStatus)

這個航班的狀態。

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

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

object (BoardingAndSeatingPolicy)

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

string

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

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

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

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

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

object (ClassTemplateInfo)

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

string

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

string

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

string (int64 format)

已淘汰

string

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

object (Message)

應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到相關訊息。這類欄位的數量上限是 10 個。

boolean

已淘汰，請改用 multipleDevicesAndHoldersAllowedStatus。

object (Uri)

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

object (LatLongPoint)

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

enum (ReviewStatus)

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

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

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

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

object (Review)

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

object (InfoModuleData)

已淘汰，請改用 textModulesData。

object (ImageModuleData)

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

object (TextModuleData)

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

object (LinksModuleData)

連結模組資料。如果物件中也定義了連結模組資料，則兩項資料都會顯示。

string (int64 format)

指出哪些兌換核發機構可透過智慧感應功能兌換票證。系統會透過核發機構 ID 來辨識兌換核發機構。兌換核發機構至少須設定一組智慧感應功能金鑰。

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

string

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

object (Image)

顯示在資訊卡正面的選用橫幅圖片。如果未提供，就不會顯示任何內容。圖片會以 100% 寬度顯示。

object (Image)

已淘汰。

boolean

識別此類別是否支援智慧感應功能。redemptionIssuers和物件層級smartTapRedemptionLevel欄位也必須正確設定，票證才能支援智慧感應功能。

string

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

object (LocalizedString)

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

enum (MultipleDevicesAndHoldersAllowedStatus)

表示是否有多位使用者和裝置會儲存參照這個類別的相同物件。

object (CallbackOptions)

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

object (SecurityAnimation)

安全動畫的選用資訊。如果設定此屬性，票證詳細資料上會顯示安全性動畫。

enum (ViewUnlockRequirement)

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

object (AppLinkData)

應用程式或網站連結 (選用) 會顯示為票證正面按鈕。如果為相對應的物件提供 AppLinkData，系統會改用該物件。