REST Resource: flightobject

資源：FlightObject

JSON 表示法 
{
  "kind": string,
  "classReference": {
    object (FlightClass)
  },
  "passengerName": string,
  "boardingAndSeatingInfo": {
    object (BoardingAndSeatingInfo)
  },
  "reservationInfo": {
    object (ReservationInfo)
  },
  "securityProgramLogo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}
欄位
kind
(deprecated)

string

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

object (FlightClass)

父項類別的沿用欄位副本。這類欄位是在 GET 執行期間擷取。
passengerName

string

必要欄位。登機證上顯示的乘客名稱。

例如：「Dave M Gahan」或「Gahan/Dave」或「GAHAN/DAVEM」
boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

有關登機和座位的乘客專屬資訊。
reservationInfo

object (ReservationInfo)

必要欄位。航班預訂資訊。
hexBackgroundColor

string

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

string

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

string

必要欄位。與這個物件相關聯的類別。必須是與這個物件同類型、已存在，並且經過核准的類別。

類別 ID 應遵循 issuer ID 的格式。identifier 的格式，其中前者是由 Google 核發，後者則由您指定。
version
(deprecated)

string (int64 format)

已淘汰
state

enum (State)

必要欄位。物件的狀態。這個欄位是用來決定物件在應用程式中的顯示方式。舉例來說，inactive 物件會移至「過期的票證」專區。
barcode

object (Barcode)

條碼類型和值。
messages[]

object (Message)

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

object (TimeInterval)

這個物件將處於 active 狀態，且可供使用。如果過了這段時間範圍，物件的狀態會變更為 expired。
locations[]

object (LatLongPoint)

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

boolean

表示物件是否有使用者。這個欄位是由平台設定。
smartTapRedemptionValue

string

系統會針對這個物件，透過 NFC 傳輸到支援智慧感應功能的感應式刷卡機的值。類別層級的欄位 enableSmartTap 和 redemptionIssuers 也必須正確設定，票證才能支援智慧感應功能。系統僅支援 ASCII 字元。
hasLinkedDevice

boolean

這個物件目前是否已連結至單一裝置。當使用者儲存物件並將物件連結到裝置時，平台會設定這個欄位。適用於特定合作夥伴。詳情請洽詢支援團隊。
disableExpirationNotification

boolean

指出是否應明確封鎖通知。如果將這個欄位設為 true，無論 messages 欄位為何，系統都會隱藏使用者的到期通知。根據預設，這個欄位是設為 false。

目前只能針對航班/機票進行設定。
infoModuleData

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

object (RotatingBarcode)

旋轉的條碼類型和值。
heroImage

object (Image)

顯示在資訊卡正面的選用橫幅圖片。如果沒有，則會顯示類別的主頁橫幅 (如有)。如果該類別的主頁橫幅也未顯示，系統就不會顯示任何內容。
groupingInfo

object (GroupingInfo)

控管票證分組方式的資訊。
passConstraints

object (PassConstraints)

傳遞物件的限制條件。包括限制 NFC 和螢幕截圖使用行為。
saveRestrictions

object (SaveRestrictions)

在使用者嘗試儲存票證前，必須驗證的物件限制。請注意，這項限制只適用於節省時間。如果在儲存票證後變更限制，新的限制就不會套用至已儲存的票證。

BoardingAndSeatingInfo

JSON 表示法 
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
欄位
kind
(deprecated)

string

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

string

這位乘客所屬的登機群組 (或區域) 值。

例如：「B」

這個值的標籤取決於這個物件所參照 flightClass 中的 boardingPolicy 欄位。
seatNumber

string

乘客座位的值。如果沒有專屬 ID，請改用 seatAssignment。

例如：「25A」
seatClass

string

座位級別的值。

例如：「經濟」或「Economy Plus」
boardingPrivilegeImage

object (Image)

登機條碼上方顯示的小圖片。航空公司可使用這張圖片說明任何登機特權。如果同時設定了安檢計畫的標誌，這張圖片可能會與該安檢計畫的標誌一起顯示。
boardingPosition

string

登機位置的值。

例如：「76」
sequenceNumber

string

登機證的序號。通常與乘客簽到的順序相符。航空公司可能會將這組號碼用於手動登機和行李標記。

例如：「49」
boardingDoor

enum (BoardingDoor)

只有在此航班登機需通過多個登機門或空橋，且您想在登機證上明確列印登機門位置時，才需要設定這個欄位。大部分的航空公司會在 seatClass 前參考登機門/空橋，引導乘客前往正確的登機門或空橋。在這類情況下，請不要設定 boardingDoor。
seatAssignment

object (LocalizedString)

乘客的座位安排。使用時機為 seatNumber 中沒有特定 ID 可用時。

例如：「在登機門出局」

BoardingDoor

列舉
BOARDING_DOOR_UNSPECIFIED
FRONT
front

FRONT 的舊版別名，已淘汰。
BACK
back

BACK 的舊版別名，已淘汰。

ReservationInfo

JSON 表示法 
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
欄位
kind
(deprecated)

string

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

string

辦理這個航班報到手續所需的確認碼。

乘客在機場的機台查詢航班及列印登機證時，必須輸入這組號碼。
eticketNumber

string

電子票券號碼。
frequentFlyerInfo

object (FrequentFlyerInfo)

飛行常客會員資訊。

FrequentFlyerInfo

JSON 表示法 
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
欄位
kind
(deprecated)

string

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

object (LocalizedString)

飛行常客計畫名稱。例如：「Lufthansa Miles &更多」
frequentFlyerNumber

string

飛行常客號碼。

對每個種類為 walletobjects#frequentFlyerInfo 的巢狀物件而言為必要項目。

方法

addmessage

 新增訊息至指定物件 ID 參照的航班物件。

get

 傳回具有指定物件 ID 的航班物件。

insert

 插入具有指定 ID 和屬性的航班物件。

list

 傳回指定核發機構 ID 的所有航班物件清單。

patch

 更新指定物件 ID 參照的航班物件。

update

 更新指定物件 ID 參照的航班物件。