REST Resource: flightobject

Tài nguyên: FlightObject

Biểu diễn dưới dạng 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)
  }
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên này. Giá trị: chuỗi cố định "walletobjects#flightObject".

classReference

object (FlightClass)

Bản sao các trường kế thừa của lớp mẹ. Các trường này được truy xuất trong quá trình GET.

passengerName

string

Bắt buộc. Tên hành khách giống với tên trên thẻ lên máy bay.

ví dụ: "Dave M Gahan" hoặc "Gahan/Dave" hoặc "GAHAN/DAVEM"

boardingAndSeatingInfo

object (BoardingAndSeatingInfo)

Thông tin cụ thể về hành khách lên máy bay và chỗ ngồi.

reservationInfo

object (ReservationInfo)

Bắt buộc. Thông tin về việc đặt vé chuyến bay.

hexBackgroundColor

string

Màu nền cho thẻ. Nếu bạn không đặt màu chủ đạo của hình ảnh chính, và nếu bạn không đặt hình ảnh chính, thì màu chủ đạo của biểu trưng sẽ được sử dụng. Định dạng là #rrggbb, trong đó rrggbb là bộ ba màu hex RGB, chẳng hạn như #ffcc00. Bạn cũng có thể sử dụng phiên bản viết tắt của bộ ba RGB là #rgb, chẳng hạn như #fc0.

id

string

Bắt buộc. Giá trị nhận dạng duy nhất của một đối tượng. Mã nhận dạng này phải là duy nhất trên tất cả các đối tượng của công ty phát hành. Giá trị này phải tuân theo định dạng issuer ID.identifier, trong đó mã bưu chính do Google phát hành còn mã sau do bạn chọn. Giá trị nhận dạng duy nhất chỉ được bao gồm ký tự chữ-số, ".", "_" hoặc "-".

classId

string

Bắt buộc. Lớp liên kết với đối tượng này. Lớp phải cùng loại với đối tượng này, phải tồn tại và phải được phê duyệt.

Mã lớp phải theo định dạng issuer ID.identifier, trong đó mã bưu chính do Google phát hành còn mã sau do bạn chọn.

version
(deprecated)

string (int64 format)

Không được dùng nữa

state

enum (State)

Bắt buộc. Trạng thái của đối tượng. Trường này được dùng để xác định cách một đối tượng xuất hiện trong ứng dụng. Ví dụ: một đối tượng inactive được di chuyển sang "Thẻ và vé đã hết hạn" .

barcode

object (Barcode)

Loại và giá trị mã vạch.

messages[]

object (Message)

Một mảng thông báo hiển thị trong ứng dụng. Tất cả người dùng của đối tượng này sẽ nhận được thông báo liên quan. Số lượng tối đa các trường này là 10.

validTimeInterval

object (TimeInterval)

Khoảng thời gian đối tượng này sẽ là active và có thể dùng đối tượng này. Trạng thái của một đối tượng sẽ được thay đổi thành expired khi khoảng thời gian này trôi qua.

locations[]

object (LatLongPoint)

Lưu ý: Trường này hiện không được hỗ trợ để kích hoạt thông báo theo vị trí địa lý.

hasUsers

boolean

Cho biết đối tượng có người dùng hay không. Trường này là do nền tảng thiết lập.

smartTapRedemptionValue

string

Giá trị sẽ được truyền đến một thiết bị đầu cuối được chứng nhận bằng tính năng Chạm thông minh qua NFC đối với vật thể này. Bạn cũng phải thiết lập chính xác các trường cấp lớp enableSmartTapredemptionIssuers để thẻ/vé hỗ trợ công nghệ Chạm thông minh. Chỉ hỗ trợ ký tự ASCII.

hasLinkedDevice

boolean

Liệu đối tượng này hiện có liên kết với một thiết bị nào hay không. Trường này do nền tảng đặt khi người dùng lưu đối tượng, liên kết đối tượng đó với thiết bị của họ. Dành cho một số đối tác chọn lọc sử dụng. Hãy liên hệ với nhóm hỗ trợ để biết thêm thông tin.

disableExpirationNotification

boolean

Cho biết liệu có cần chặn thông báo một cách rõ ràng hay không. Nếu bạn đặt trường này thành true, thì thông báo hết hạn cho người dùng sẽ bị chặn, bất kể trường messages là gì. Theo mặc định, trường này được đặt thành false.

Hiện tại, bạn chỉ có thể đặt chế độ cài đặt này cho Chuyến bay.

infoModuleData

object (InfoModuleData)

Không dùng nữa. Thay vào đó, hãy sử dụng textModulesData.

imageModulesData[]

object (ImageModuleData)

Dữ liệu mô-đun hình ảnh. Số lượng trường tối đa được hiển thị là 1 trường ở cấp đối tượng và 1 trường ở cấp đối tượng lớp.

textModulesData[]

object (TextModuleData)

Dữ liệu mô-đun văn bản. Nếu dữ liệu mô-đun văn bản cũng được xác định trên lớp này, thì cả hai đều sẽ hiển thị. Số lượng tối đa các trường này được hiển thị là 10 trường từ đối tượng và 10 trường từ lớp.

rotatingBarcode

object (RotatingBarcode)

Giá trị và loại mã vạch xoay vòng.

heroImage

object (Image)

Ảnh biểu ngữ không bắt buộc xuất hiện ở mặt trước của thẻ. Nếu không có lớp nào, hình ảnh chính của lớp (nếu có) sẽ xuất hiện. Nếu cũng không có hình ảnh chính của lớp, thì sẽ không có nội dung nào hiển thị.

groupingInfo

object (GroupingInfo)

Thông tin kiểm soát cách nhóm thẻ và vé lại với nhau.

passConstraints

object (PassConstraints)

Truyền các quy tắc ràng buộc cho đối tượng. Bao gồm việc hạn chế hành vi NFC và ảnh chụp màn hình.

saveRestrictions

object (SaveRestrictions)

Các hạn chế đối với đối tượng cần được xác minh trước khi người dùng cố gắng lưu thẻ và vé. Xin lưu ý rằng các hạn chế này sẽ chỉ áp dụng trong thời gian tiết kiệm. Nếu các quy định hạn chế thay đổi sau khi người dùng lưu thẻ và vé, thì các hạn chế mới sẽ không áp dụng cho một thẻ và vé đã lưu.

BoardingAndSeatingInfo

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên này. Giá trị: chuỗi cố định "walletobjects#boardingAndSeatingInfo".

boardingGroup

string

Giá trị của nhóm lên máy bay (hoặc khu vực) mà hành khách này sẽ lên tàu.

ví dụ: "B"

Nhãn cho giá trị này sẽ được xác định bằng trường boardingPolicy trong flightClass được đối tượng này tham chiếu.

seatNumber

string

Giá trị của ghế hành khách. Nếu không có giá trị nhận dạng cụ thể, hãy sử dụng seatAssignment.

ví dụ: "25A"

seatClass

string

Giá trị của hạng ghế.

ví dụ: "Tiết kiệm" hoặc "Business Plus"

boardingPrivilegeImage

object (Image)

Một hình ảnh nhỏ phía trên mã vạch lên máy bay. Các hãng hàng không có thể dùng thông tin này để thông báo bất kỳ đặc quyền lên máy bay nào. Trong trường hợp bạn cũng đặt biểu trưng của chương trình bảo mật, hình ảnh này có thể hiển thị cùng với biểu trưng của chương trình bảo mật đó.

boardingPosition

string

Giá trị của vị trí lên máy bay.

ví dụ: "76"

sequenceNumber

string

Số thứ tự trên thẻ lên máy bay. Tên này thường khớp với trình tự hành khách làm thủ tục. Hãng hàng không có thể sử dụng mã số này để gắn thẻ lên máy bay và gắn thẻ hành lý theo cách thủ công.

ví dụ: "49"

boardingDoor

enum (BoardingDoor)

Chỉ thiết lập trường này nếu máy bay này đi qua nhiều cửa hoặc cầu và bạn muốn in rõ vị trí cửa trên thẻ lên máy bay. Hầu hết các hãng hàng không đều định tuyến hành khách của họ đến đúng cửa hoặc cầu bằng cách tham chiếu đến cửa ra vào/cầu nối của seatClass. Trong những trường hợp đó, bạn không nên đặt boardingDoor.

seatAssignment

object (LocalizedString)

Ghế ngồi cho hành khách. Được sử dụng khi không có giá trị nhận dạng cụ thể để sử dụng trong seatNumber.

ví dụ: "được chỉ định tại cổng"

BoardingDoor

Enum
BOARDING_DOOR_UNSPECIFIED
FRONT
front

Bí danh cũ của FRONT. Không dùng nữa.

BACK
back

Bí danh cũ của BACK. Không dùng nữa.

ReservationInfo

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên này. Giá trị: chuỗi cố định "walletobjects#reservationInfo".

confirmationCode

string

Cần có mã xác nhận để làm thủ tục cho chuyến bay này.

Đây là số mà hành khách sẽ nhập vào kiosk tại sân bay để tra cứu chuyến bay và in thẻ lên máy bay.

eticketNumber

string

Mã số vé điện tử.

frequentFlyerInfo

object (FrequentFlyerInfo)

Thông tin về gói thành viên khách bay thường xuyên.

FrequentFlyerInfo

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên này. Giá trị: chuỗi cố định "walletobjects#frequentFlyerInfo".

frequentFlyerProgramName

object (LocalizedString)

Tên chương trình khách bay thường xuyên. ví dụ: "Lufthansa Miles & Khác"

frequentFlyerNumber

string

Số chuyến bay thường xuyên.

Bắt buộc đối với mỗi đối tượng lồng nhau thuộc loại walletobjects#frequentFlyerInfo.

Phương thức

addmessage

Thêm thông báo vào đối tượng bay được tham chiếu theo mã đối tượng đã cho.

get

Trả về đối tượng chuyến bay có mã đối tượng đã cho.

insert

Chèn một đối tượng chuyến bay có mã nhận dạng và thuộc tính đã cho.

list

Trả về danh sách tất cả đối tượng chuyến bay cho một mã nhà phát hành cụ thể.

patch

Cập nhật đối tượng chuyến bay được tham chiếu theo mã đối tượng đã cho.

update

Cập nhật đối tượng chuyến bay được tham chiếu theo mã đối tượng đã cho.