REST Resource: flightobject

{
  "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)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

string

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

object (FlightClass)

Bản sao của 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.

string

Bắt buộc. Tên hành khách như tên xuất hiện trên thẻ lên máy bay.

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

object (BoardingAndSeatingInfo)

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

object (ReservationInfo)

Bắt buộc. Thông tin về yêu cầu đặt trước chuyến bay.

object (Image)

Hình ảnh về chương trình an ninh áp dụng cho hành khách.

string

Màu nền cho thẻ. Nếu bạn không đặt, hệ thống sẽ sử dụng màu chủ đạo của hình ảnh chính và nếu bạn không đặt hình ảnh chính, hệ thống sẽ sử dụng màu chủ đạo của biểu trưng. Định dạng là #rrggbb, trong đó rrggbb là bộ ba RGB thập lục phân, 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.

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 một công ty phát hành. Giá trị này phải tuân theo định dạng issuer ID.identifier, trong đó mã nhận dạng trước do Google phát hành và mã nhận dạng sau do bạn chọn. Giá trị nhận dạng duy nhất chỉ được chứa các ký tự chữ và số, dấu chấm ("."), dấu gạch dưới ("_") hoặc dấu gạch ngang ("-").

string

Bắt buộc. Lớp liên kết với đối tượng này. Lớp này phải thuộc 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 tuân theo định dạng issuer ID.identifier, trong đó mã nhận dạng trước do Google phát hành và mã nhận dạng sau do bạn chọn.

string (int64 format)

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

enum (State)

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

object (Barcode)

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

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.

object (TimeInterval)

Khoảng thời gian đối tượng này sẽ là active và đối tượng có thể được sử dụng. 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.

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í.

boolean

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

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 đúng cách các trường cấp lớp enableSmartTap và redemptionIssuers để thẻ và vé hỗ trợ tính năng Chạm thông minh. Chỉ hỗ trợ các ký tự ASCII.

boolean

Liệu đối tượng này có đang được liên kết với một thiết bị 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. Hãy liên hệ với nhóm hỗ trợ để biết thêm thông tin.

boolean

Cho biết liệu thông báo có bị chặn rõ ràng hay không. Nếu bạn đặt trường này thành true, bất kể trường messages là gì, thông báo hết hạn cho người dùng sẽ bị chặn. 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.

object (InfoModuleData)

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

object (ImageModuleData)

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

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, thì cả hai sẽ hiển thị. Số lượng tối đa của các trường này hiển thị là 10 từ đối tượng và 10 từ lớp.

object (LinksModuleData)

Liên kết dữ liệu mô-đun. Nếu dữ liệu mô-đun đường liên kết cũng được xác định trên lớp, thì cả hai sẽ hiển thị.

object (AppLinkData)

Đường liên kết đến ứng dụng hoặc trang web (không bắt buộc) sẽ hiển thị dưới dạng nút ở mặt trước của thẻ và vé. Nếu bạn cung cấp AppLinkData cho đối tượng lớp tương ứng, thì chỉ đối tượng AppLinkData mới hiển thị.

object (RotatingBarcode)

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

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ó hình ảnh 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ị.

object (GroupingInfo)

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

object (PassConstraints)

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

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 quy định hạn chế này sẽ chỉ được áp dụng trong thời gian tiết kiệm pin. 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 quy định hạn chế mới sẽ không được áp dụng cho thẻ và vé đã lưu.

string

linkedObjectIds là danh sách các đối tượng khác như vé xem sự kiện, thẻ khách hàng thân thiết, ưu đãi, chung, thẻ quà tặng, thẻ đi phương tiện công cộng và thẻ lên máy bay sẽ tự động được đính kèm vào đối tượng chuyến bay này. Nếu người dùng đã lưu thẻ lên máy bay này, thì các linkedObjectId này sẽ tự động được đẩy vào ví của người dùng (trừ phi họ tắt chế độ cài đặt để nhận các thẻ và vé được liên kết như vậy).

Đảm bảo rằng các đối tượng có trong linkedObjectIds đã được chèn – nếu không, các lệnh gọi sẽ không thành công. Sau khi liên kết, bạn không thể huỷ liên kết các đối tượng đã liên kết. Bạn không thể liên kết các đối tượng thuộc về một tổ chức phát hành khác. Có giới hạn về số lượng đối tượng có thể được liên kết với một đối tượng. Sau khi đạt đến giới hạn, các đối tượng liên kết mới trong lệnh gọi sẽ bị bỏ qua một cách tự động.

Mã đối tượng phải tuân theo định dạng issuer ID.identifier, trong đó mã nhận dạng trước do Google phát hành và mã nhận dạng sau do bạn chọn.

enum (NotificationSettingsForUpdates)

Liệu việc cập nhật trường cho đối tượng này có kích hoạt thông báo hay không. Khi được đặt thành NOTIFY, chúng tôi sẽ cố gắng kích hoạt thông báo cập nhật trường cho người dùng. Chúng tôi sẽ chỉ gửi các thông báo này cho người dùng nếu trường này nằm trong danh sách cho phép. Nếu bạn đặt thành DO_NOT_NOTIFY hoặc NOTIFICATION_SETTINGS_UNSPECIFIED, thì hệ thống sẽ không kích hoạt thông báo nào. Chế độ cài đặt này là tạm thời và cần được đặt với mỗi yêu cầu PATCH hoặc UPDATE, nếu không thông báo sẽ không được kích hoạt.

object (ValueAddedModuleData)

Dữ liệu mô-đun giá trị gia tăng không bắt buộc. Tối đa 10 đối tượng trên đối tượng.

{
  "kind": string,
  "boardingGroup": string,
  "seatNumber": string,
  "seatClass": string,
  "boardingPrivilegeImage": {
    object (Image)
  },
  "boardingPosition": string,
  "sequenceNumber": string,
  "boardingDoor": enum (BoardingDoor),
  "seatAssignment": {
    object (LocalizedString)
  }
}

string

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

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 máy bay.

ví dụ: "B"

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

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"

string

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

ví dụ: "Hạng phổ thông" hoặc "Hạng phổ thông nâng cao"

object (Image)

Một hình ảnh nhỏ xuất hiện phía trên mã vạch lên máy bay. Các hãng hàng không có thể sử dụng mã này để thông báo mọi đặc quyền lên máy bay. 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ể được kết xuất cùng với biểu trưng của chương trình bảo mật đó.

string

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

ví dụ: "76"

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 số này để làm thẻ lên máy bay và thẻ hành lý theo cách thủ công.

ví dụ: "49"

enum (BoardingDoor)

Chỉ đặt trường này nếu chuyến bay này lên máy bay 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 đưa hành khách đến đúng cửa hoặc cầu nối bằng cách tham chiếu đến các cửa/cầu nối bằng seatClass. Trong những trường hợp đó, bạn không nên đặt boardingDoor.

object (LocalizedString)

Ghế được chỉ định cho hành khách. 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"

{
  "kind": string,
  "confirmationCode": string,
  "eticketNumber": string,
  "frequentFlyerInfo": {
    object (FrequentFlyerInfo)
  }
}

string

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

string

Bạn 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 một ki-ốt tại sân bay để tra cứu chuyến bay và in thẻ lên máy bay.

string

Số vé điện tử.

object (FrequentFlyerInfo)

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

{
  "kind": string,
  "frequentFlyerProgramName": {
    object (LocalizedString)
  },
  "frequentFlyerNumber": string
}

string

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

object (LocalizedString)

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

string

Số khách 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.