REST Resource: flightclass

Tài nguyên: FlightClass

Biểu diễn dưới dạng JSON 
{
  "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),
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Trường
kind
(deprecated)

string

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

string

Bắt buộc. Ngày và giờ dự kiến máy bay rời khỏi cổng (không phải rời khỏi đường băng)

Lưu ý: Trường này không được thay đổi quá gần thời gian khởi hành. Để biết thông tin cập nhật về thời gian khởi hành (bị trễ, v.v.), vui lòng đặt localEstimatedOrActualDepartureDateTime.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch. Thời gian có thể được chỉ định với độ chính xác lên đến từng mili giây.

ví dụ: 2027-03-05T06:30:00

Đây phải là ngày/giờ theo múi giờ địa phương tại sân bay (không phải giờ UTC).

Google sẽ từ chối yêu cầu nếu bạn cung cấp độ lệch UTC. Google sẽ tính múi giờ dựa trên sân bay khởi hành.
localEstimatedOrActualDepartureDateTime

string

Thời gian ước tính mà máy bay dự định rời khỏi cổng hoặc thời gian thực tế mà máy bay đã rời khỏi cổng. Lưu ý: Đây không phải là thời gian cất cánh.

Bạn nên đặt trường này nếu đáp ứng ít nhất một trong các điều kiện sau:

  • Thời gian này khác với thời gian đã lên lịch. Google sẽ sử dụng dữ liệu này để tính toán độ trễ.
  • Máy bay đã rời khỏi cổng. Google sẽ sử dụng thông tin này để thông báo cho người dùng về thời điểm chuyến bay thực sự khởi hành.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác đến mili giây.

ví dụ: 2027-03-05T06:30:00

Đây phải là ngày/giờ theo múi giờ địa phương tại sân bay (không phải giờ UTC).

Google sẽ từ chối yêu cầu nếu bạn cung cấp độ lệch UTC. Google sẽ tính múi giờ dựa trên sân bay khởi hành.
localBoardingDateTime

string

Thời gian lên máy bay như được in trên thẻ lên máy bay.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601 không có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác đến mili giây.

ví dụ: 2027-03-05T06:30:00

Đây phải là ngày/giờ theo múi giờ địa phương tại sân bay (không phải giờ UTC).

Google sẽ từ chối yêu cầu nếu bạn cung cấp độ lệch UTC. Google sẽ tính múi giờ dựa trên sân bay khởi hành.
localScheduledArrivalDateTime

string

Thời gian dự kiến mà máy bay dự định đến cổng đích (không phải đường băng).

Lưu ý: Không được thay đổi trường này quá sát với thời gian bay. Để cập nhật thời gian khởi hành (độ trễ, v.v.), vui lòng đặt localEstimatedOrActualArrivalDateTime.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác đến mili giây.

ví dụ: 2027-03-05T06:30:00

Đây phải là ngày/giờ theo múi giờ địa phương tại sân bay (không phải giờ UTC).

Google sẽ từ chối yêu cầu nếu có thời gian bù giờ UTC. Google sẽ tính múi giờ dựa trên sân bay đến.
localEstimatedOrActualArrivalDateTime

string

Thời gian ước tính mà máy bay dự kiến sẽ đến cổng đến (không phải đường băng) hoặc thời gian thực tế mà máy bay đến cổng đến.

Bạn phải đặt trường này nếu có ít nhất một trong các điều kiện bên dưới là đúng:

  • Thời gian này khác với thời gian đã lên lịch. Google sẽ sử dụng thông tin này để tính độ trễ.
  • Máy bay đã đến cổng. Google sẽ sử dụng thông tin này để thông báo cho người dùng rằng chuyến bay đã đến cổng.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601 mà không có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác đến mili giây.

ví dụ: 2027-03-05T06:30:00

Đây phải là ngày/giờ theo múi giờ địa phương tại sân bay (không phải giờ UTC).

Google sẽ từ chối yêu cầu nếu có thời gian bù giờ UTC. Google sẽ tính múi giờ dựa trên sân bay đến.
flightHeader

object (FlightHeader)

Bắt buộc. Thông tin về hãng hàng không và số chuyến bay.
origin

object (AirportInfo)

Bắt buộc. Sân bay khởi hành.
destination

object (AirportInfo)

Bắt buộc. Sân bay đến.
flightStatus

enum (FlightStatus)

Trạng thái của chuyến bay này.

Nếu bạn không đặt chính sách này, Google sẽ tính toán trạng thái dựa trên dữ liệu từ các nguồn khác, chẳng hạn như thống kê chuyến bay, v.v.

Lưu ý: Trạng thái do Google tính toán sẽ không được trả về trong các phản hồi API.
boardingAndSeatingPolicy

object (BoardingAndSeatingPolicy)

Chính sách lên máy bay và chỗ ngồi. Các thông số này sẽ cho người dùng biết nhãn nào sẽ hiển thị cho người dùng.
localGateClosingDateTime

string

Giờ đóng cổng như được in trên thẻ lên máy bay. Đừng đặt trường này nếu bạn không muốn in thông tin này trong thẻ lên máy bay.

Đây là ngày/giờ theo định dạng mở rộng ISO 8601 mà không có giá trị bù trừ. Bạn có thể chỉ định thời gian với độ chính xác đến mili giây.

ví dụ: 2027-03-05T06:30:00

Đây phải là ngày/giờ theo múi giờ địa phương tại sân bay (không phải giờ UTC).

Google sẽ từ chối yêu cầu nếu có thời gian bù giờ UTC. Google sẽ tính múi giờ dựa trên sân bay khởi hành.
classTemplateInfo

object (ClassTemplateInfo)

Thông tin mẫu về cách hiển thị lớp. Nếu bạn không đặt giá trị, Google sẽ sử dụng một tập hợp trường mặc định để hiển thị.
languageOverride

string

Nếu có trường này, thẻ lên máy bay được phân phát đến thiết bị của người dùng sẽ luôn ở ngôn ngữ này. Biểu thị thẻ ngôn ngữ BCP 47. Giá trị mẫu là "en-US", "en-GB", "de" hoặc "de-AT".
id

string

Bắt buộc. Giá trị nhận dạng duy nhất của một lớp. Mã nhận dạng này phải là duy nhất trên tất cả các lớp của một tổ chức 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 của bạn 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 nối ("-").
version
(deprecated)

string (int64 format)

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

string

Bắt buộc. Tên tổ chức phát hành. Độ dài tối đa đề xuất là 20 ký tự để đảm bảo chuỗi đầy đủ hiển thị trên màn hình nhỏ hơn.
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ủa các trường này là 10.
allowMultipleUsersPerObject
(deprecated)

boolean

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

object (Uri)

URI của trang chủ ứng dụng. Việc điền sẵn URI trong trường này dẫn đến hành vi chính xác tương tự như điền URI trong linksModuleData (khi một đối tượng được kết xuất, một đường liên kết đến trang chủ sẽ xuất hiện ở phần thường được coi là phần linksModuleData của đối tượng).
locations[]
(deprecated)

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

enum (ReviewStatus)

Bắt buộc. Trạng thái của lớp học. Bạn có thể đặt trường này thành draft hoặc underReview bằng cách sử dụng lệnh gọi API chèn, vá hoặc cập nhật. Sau khi thay đổi trạng thái xem xét từ draft, bạn không thể thay đổi trạng thái này về draft.

Bạn nên giữ trường này thành draft khi lớp đang trong quá trình phát triển. Không thể dùng lớp draft để tạo đối tượng nào.

Bạn nên đặt trường này thành underReview khi cho rằng lớp đã sẵn sàng để sử dụng. Nền tảng sẽ tự động đặt trường này thành approved và trường này có thể được dùng ngay để tạo hoặc di chuyển đối tượng.

Khi cập nhật một lớp đã là approved, bạn nên tiếp tục đặt trường này thành underReview.
review

object (Review)

Bình luận đánh giá do nền tảng đặt ra khi một lớp được đánh dấu là approved hoặc rejected.
infoModuleData
(deprecated)

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 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.
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, 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.
redemptionIssuers[]

string (int64 format)

Xác định những đơn vị phát hành có thể sử dụng thẻ và vé qua tính năng Nhấn thông minh. Bên phát hành mã thưởng được xác định bằng mã nhận dạng bên phát hành. Tổ chức phát hành ưu đãi phải thiết lập ít nhất một khoá Chạm thông minh.

Bạn cũng phải thiết lập đúng cách các trường enableSmartTap và smartTapRedemptionLevel cấp đối tượng để thẻ và vé có thể hỗ trợ tính năng Chạm thông minh.
countryCode

string

Mã quốc gia dùng để cho thấy quốc gia của thẻ (khi người dùng không ở quốc gia đó) cũng như để hiện nội dung được bản địa hoá khi không có nội dung bằng ngôn ngữ của người dùng.
heroImage

object (Image)

Hình ảnh biểu ngữ không bắt buộc xuất hiện ở mặt trước thẻ. Nếu không có, thì sẽ không có nội dung nào hiển thị. Hình ảnh sẽ hiển thị ở chiều rộng 100%.
wordMark
(deprecated)

object (Image)

Không dùng nữa.
enableSmartTap

boolean

Xác định xem lớp này có hỗ trợ tính năng Nhấn thông minh hay không. Bạn cũng phải thiết lập đúng cách các trường redemptionIssuers và smartTapRedemptionLevel cấp đối tượng để thẻ và vé có thể hỗ trợ tính năng Chạm thông minh.
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 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.
localizedIssuerName

object (LocalizedString)

Các chuỗi đã được dịch choNhà phát hànhName. Độ dài tối đa đề xuất là 20 ký tự để đảm bảo chuỗi đầy đủ hiển thị trên màn hình nhỏ hơn.
multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Xác định xem nhiều người dùng và thiết bị có lưu cùng một đối tượng tham chiếu đến lớp này hay không.
callbackOptions

object (CallbackOptions)

Các tuỳ chọn gọi lại được dùng để gọi lại phương thức phát hành cho mỗi lần người dùng cuối lưu/xoá đối tượng cho lớp này. Tất cả đối tượng của lớp này đều đủ điều kiện để gọi lại.
securityAnimation

object (SecurityAnimation)

Thông tin không bắt buộc về ảnh động bảo mật. Nếu bạn đặt giá trị này, ảnh động bảo mật sẽ hiển thị trên thông tin chi tiết của thẻ và vé.
viewUnlockRequirement

enum (ViewUnlockRequirement)

Xem các tuỳ chọn Yêu cầu mở khoá cho thẻ lên máy bay.
notifyPreference

enum (NotificationSettingsForUpdates)

Liệu nội dung cập nhật trường cho lớp 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 không chỉ định thì sẽ không có thông báo nào được kích hoạt. 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.
valueAddedModuleData[]

object (ValueAddedModuleData)

Dữ liệu mô-đun giá trị gia tăng không bắt buộc. Tối đa 10 người trong lớp này. Đối với một thẻ và vé, chỉ 10 thẻ và vé sẽ hiển thị, ưu tiên những thẻ và vé từ đối tượng.

FlightHeader

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "carrier": {
    object (FlightCarrier)
  },
  "flightNumber": string,
  "operatingCarrier": {
    object (FlightCarrier)
  },
  "operatingFlightNumber": string,
  "flightNumberDisplayOverride": string
}
Trường
kind
(deprecated)

string

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

object (FlightCarrier)

Thông tin về hãng hàng không. Đây là thuộc tính bắt buộc của flightHeader.
flightNumber

string

Số hiệu chuyến bay không có mã của hãng vận chuyển IATA. Trường này chỉ được chứa chữ số. Đây là thuộc tính bắt buộc của flightHeader.

ví dụ: "123"
operatingCarrier

object (FlightCarrier)

Thông tin về hãng hàng không khai thác chuyến bay.
operatingFlightNumber

string

Số hiệu chuyến bay do hãng hàng không khai thác sử dụng mà không có mã hãng hàng không IATA. Trường này chỉ được chứa chữ số.

ví dụ: "234"
flightNumberDisplayOverride

string

Giá trị ghi đè để sử dụng cho số chuyến bay. Giá trị mặc định dùng cho mục đích hiển thị là hãng hàng không + số chuyến bay. Nếu cần hiển thị một giá trị khác cho hành khách, hãy sử dụng trường này để ghi đè hành vi mặc định.

ví dụ: "XX1234 / YY576"

FlightCarrier

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "carrierIataCode": string,
  "carrierIcaoCode": string,
  "airlineName": {
    object (LocalizedString)
  },
  "airlineLogo": {
    object (Image)
  },
  "airlineAllianceLogo": {
    object (Image)
  },
  "wideAirlineLogo": {
    object (Image)
  }
}
Trường
kind
(deprecated)

string

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

string

Mã hãng hàng không IATA gồm hai ký tự của hãng hàng không tiếp thị (không phải hãng hàng không khai thác). Bạn cần cung cấp chính xác một trong số này hoặc carrierIcaoCode cho carrier và operatingCarrier.

Ví dụ: "LX" cho hãng hàng không Swiss Air
carrierIcaoCode

string

Mã hãng hàng không ICAO gồm ba ký tự của hãng vận chuyển tiếp thị (chứ không phải hãng vận hành). Bạn cần cung cấp chính xác một trong số này hoặc carrierIataCode cho carrier và operatingCarrier.

Ví dụ: "EZY" cho Easy Jet
airlineName

object (LocalizedString)

Tên đã bản địa hoá của hãng hàng không do carrierIataCode chỉ định. Nếu bạn không đặt chính sách này, issuerName hoặc localizedIssuerName trong FlightClass sẽ được dùng cho mục đích hiển thị.

ví dụ: "Swiss Air" cho "LX"

AirportInfo

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

string

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

string

Mã sân bay IATA gồm ba ký tự. Đây là trường bắt buộc cho origin và destination.

Ví dụ: "SFO"
terminal

string

Tên thiết bị đầu cuối. Ví dụ: "INTL" hoặc "I"
gate

string

Tên của cổng. Ví dụ: "B59" hoặc "59"
airportNameOverride

object (LocalizedString)

Trường không bắt buộc sẽ ghi đè tên thành phố của sân bay do IATA xác định. Theo mặc định, Google sẽ lấy airportIataCode được cung cấp và liên kết thông tin này với tên thành phố chính thức của sân bay do IATA quy định.

Bạn có thể xem tên thành phố sân bay chính thức của IATA trên trang web Tên thành phố sân bay của IATA. Ví dụ: Đối với mã IATA của sân bay "LTN", trang web của IATA cho chúng tôi biết thành phố sân bay tương ứng là "London".

Nếu bạn không điền trường này, Google sẽ hiển thị "London".

Tuy nhiên, việc điền tên tuỳ chỉnh vào trường này (ví dụ: "London Luton") sẽ ghi đè tên đó.

FlightStatus

Enum
FLIGHT_STATUS_UNSPECIFIED
SCHEDULED Chuyến bay đúng giờ, sớm hoặc bị trễ.
scheduled

Bí danh cũ của SCHEDULED. Không dùng nữa.
ACTIVE Chuyến bay đang diễn ra (chuyển động trên đường băng, cất cánh, hạ cánh, trên không).
active

Bí danh cũ của ACTIVE. Không dùng nữa.
LANDED Chuyến bay đã hạ cánh tại điểm đến ban đầu.
landed

Bí danh cũ của LANDED. Không dùng nữa.
CANCELLED Chuyến bay đã bị huỷ.
cancelled

Bí danh cũ của CANCELLED. Không dùng nữa.
REDIRECTED Chuyến bay bay bằng đường hàng không nhưng đến một sân bay khác với điểm đến ban đầu.
redirected

Bí danh cũ của REDIRECTED. Không dùng nữa.
DIVERTED Chuyến bay đã hạ cánh tại một sân bay khác với điểm đến ban đầu.
diverted

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

BoardingAndSeatingPolicy

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "boardingPolicy": enum (BoardingPolicy),
  "seatClassPolicy": enum (SeatClassPolicy)
}
Trường
kind
(deprecated)

string

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

enum (BoardingPolicy)

Cho biết chính sách mà hãng hàng không sử dụng để lên máy bay. Nếu bạn không đặt giá trị này, Google sẽ mặc định là zoneBased.
seatClassPolicy

enum (SeatClassPolicy)

Chính sách về chỗ ngồi quy định cách chúng tôi hiển thị hạng ghế. Nếu bạn không đặt giá trị này, Google sẽ mặc định là cabinBased.

BoardingPolicy

Enum
BOARDING_POLICY_UNSPECIFIED
ZONE_BASED
zoneBased

Bí danh cũ của ZONE_BASED. Không dùng nữa.
GROUP_BASED
groupBased

Bí danh cũ của GROUP_BASED. Không dùng nữa.
BOARDING_POLICY_OTHER
boardingPolicyOther

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

SeatClassPolicy

Enum
SEAT_CLASS_POLICY_UNSPECIFIED
CABIN_BASED
cabinBased

Bí danh cũ của CABIN_BASED. Không dùng nữa.
CLASS_BASED
classBased

Bí danh cũ của CLASS_BASED. Không dùng nữa.
TIER_BASED
tierBased

Bí danh cũ của TIER_BASED. Không dùng nữa.
SEAT_CLASS_POLICY_OTHER
seatClassPolicyOther

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

Phương thức

addmessage

 Thêm thông báo vào lớp chuyến bay được tham chiếu bằng mã lớp đã cho.

get

 Trả về hạng vé máy bay có mã hạng vé đã cho.

insert

 Chèn một lớp chuyến bay có mã nhận dạng và thuộc tính đã cho.

list

 Trả về danh sách tất cả các hạng vé máy bay cho một mã số phát hành nhất định.

patch

 Cập nhật loại chuyến bay được tham chiếu bằng mã lớp nhất định.

update

 Cập nhật loại chuyến bay được tham chiếu bằng mã lớp nhất định.