REST Resource: transitobject

Tài nguyên: TransitObject

Biểu diễn dưới dạng JSON
{
  "classReference": {
    object (TransitClass)
  },
  "ticketNumber": string,
  "passengerType": enum (PassengerType),
  "passengerNames": string,
  "tripId": string,
  "ticketStatus": enum (TicketStatus),
  "customTicketStatus": {
    object (LocalizedString)
  },
  "concessionCategory": enum (ConcessionCategory),
  "customConcessionCategory": {
    object (LocalizedString)
  },
  "ticketRestrictions": {
    object (TicketRestrictions)
  },
  "purchaseDetails": {
    object (PurchaseDetails)
  },
  "ticketLeg": {
    object (TicketLeg)
  },
  "ticketLegs": [
    {
      object (TicketLeg)
    }
  ],
  "hexBackgroundColor": string,
  "tripType": enum (TripType),
  "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)
  },
  "activationStatus": {
    object (ActivationStatus)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "deviceContext": {
    object (DeviceContext)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Trường
classReference

object (TransitClass)

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.

ticketNumber

string

Số vé. Đây là mã nhận dạng duy nhất của vé trong hệ thống của nhà điều hành phương tiện công cộng.

passengerType

enum (PassengerType)

Số lượng hành khách.

passengerNames

string

(Các) tên của hành khách được chỉ định vé. Trường passengerType ở trên dùng để cung cấp ngữ cảnh cho Google về trường này.

tripId

string

Mã nhận dạng này được dùng để nhóm các vé lại với nhau nếu người dùng đã lưu nhiều vé cho cùng một chuyến đi.

ticketStatus

enum (TicketStatus)

Trạng thái của vé. Đối với các trạng thái ảnh hưởng đến màn hình, hãy sử dụng trường state.

customTicketStatus

object (LocalizedString)

Trạng thái tuỳ chỉnh để dùng cho giá trị trạng thái của phiếu yêu cầu hỗ trợ khi ticketStatus không cung cấp lựa chọn phù hợp. Không thể đặt cả ticketStatuscustomTicketStatus.

concessionCategory

enum (ConcessionCategory)

Danh mục ưu đãi cho vé.

customConcessionCategory

object (LocalizedString)

Danh mục đặc quyền tuỳ chỉnh để sử dụng khi concessionCategory không cung cấp tuỳ chọn phù hợp. Bạn có thể không thiết lập được cả concessionCategorycustomConcessionCategory.

ticketRestrictions

object (TicketRestrictions)

Thông tin về các quy định hạn chế khi sử dụng vé này. Ví dụ: ngày trong tuần phải sử dụng hoặc tuyến đường được phép đi.

purchaseDetails

object (PurchaseDetails)

Thông tin chi tiết về giao dịch mua vé này.

ticketLeg

object (TicketLeg)

Một chặng vé chứa thông tin về thời gian khởi hành và thời gian đến cùng với thông tin lên máy bay và chỗ ngồi. Nếu bạn cần chỉ định nhiều chặng, hãy sử dụng trường ticketLegs. Không thể đặt cả ticketLegticketLegs.

ticketLegs[]

object (TicketLeg)

Mỗi vé có thể chứa một hoặc nhiều chặng. Mỗi chặng bay chứa thông tin về thời gian khởi hành và đến cùng với thông tin về việc lên máy bay và chỗ ngồi. Nếu chỉ định một chân, hãy sử dụng trường ticketLeg. Không thể đặt cả ticketLegticketLegs.

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.

tripType

enum (TripType)

Bắt buộc. Loại chuyến đi mà đối tượng phương tiện công cộng này đại diện. Dùng để xác định tiêu đề thẻ và/hoặc ký hiệu cần sử dụng giữa điểm xuất phát và điểm đến.

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 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 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 ("-").

classId

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.

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 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 chuyển sang phần "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 các thông báo liên quan. Số lượng tối đa củ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à đối tượng có thể được sử dụng. Trạng thái của đối tượng sẽ được thay đổi thành expired khi khoảng thời gian này đã trôi qua.

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

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 thiết bị đầu cuối được chứng nhận Smart Tap qua NFC cho đối tượng này. Bạn cũng phải thiết lập đúng cách các trường cấp lớp enableSmartTapredemptionIssuers để thẻ và vé hỗ trợ tính năng Chạm thông minh. Chỉ hỗ trợ các 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 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 giá trị này cho các mặt hàng.

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

activationStatus

object (ActivationStatus)

Trạng thái kích hoạt của đối tượng. Bắt buộc nếu lớp đã đặt activationOptions.

rotatingBarcode

object (RotatingBarcode)

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

deviceContext

object (DeviceContext)

Ngữ cảnh thiết bị liên kết với đối tượ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ó hình ảnh nào, hình ảnh chính của lớp (nếu có) sẽ xuất hiện. Nếu hình ảnh chính của lớp học cũng không có, thì sẽ không có nội dung nào xuất hiện.

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

linkedObjectIds[]

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 thẻ đi phương tiện công cộng này. Nếu người dùng đã lưu thẻ đi phương tiện công cộng 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 đó).

Đả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ã bưu chính do Google phát hành còn mã sau do bạn chọn.

notifyPreference

enum (NotificationSettingsForUpdates)

Liệu nội dung 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. Những thông báo này sẽ chỉ được gửi đến người dùng nếu trường đó 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 thiết lập cho từng 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 đối tượng trên đối tượng.

PassengerType

Enum
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

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

MULTIPLE_PASSENGERS
multiplePassengers

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

TicketStatus

Enum
TICKET_STATUS_UNSPECIFIED
USED
used

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

REFUNDED
refunded

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

EXCHANGED
exchanged

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

ConcessionCategory

Enum
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

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

CHILD
child

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

SENIOR
senior

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

TicketRestrictions

Biểu diễn dưới dạng JSON
{
  "routeRestrictions": {
    object (LocalizedString)
  },
  "routeRestrictionsDetails": {
    object (LocalizedString)
  },
  "timeRestrictions": {
    object (LocalizedString)
  },
  "otherRestrictions": {
    object (LocalizedString)
  }
}
Trường
routeRestrictions

object (LocalizedString)

Quy định hạn chế về các tuyến đường có thể đi. Ví dụ: đây có thể là chuỗi "Chỉ dành cho tàu CrossCountry đã đặt trước".

routeRestrictionsDetails

object (LocalizedString)

Thông tin chi tiết khác về routeRestrictions ở trên.

timeRestrictions

object (LocalizedString)

Quy định hạn chế về thời gian có thể sử dụng vé này.

otherRestrictions

object (LocalizedString)

Các quy định hạn chế bổ sung không thuộc danh mục "tuyến đường" hoặc "thời gian".

PurchaseDetails

Biểu diễn dưới dạng JSON
{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object (TicketCost)
  }
}
Trường
purchaseReceiptNumber

string

Số biên nhận/mã nhận dạng để theo dõi việc mua vé thông qua cơ quan đã bán vé.

purchaseDateTime

string

Ngày/giờ mua vé.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601, có hoặc không có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác lên đến nano giây. Bạn có thể chỉ định độ lệch với độ chính xác đến giây (mặc dù độ lệch giây không thuộc tiêu chuẩn ISO 8601).

Ví dụ:

1985-04-12T23:20:50.52Z sẽ là 20 phút và 50,52 giây sau 23 giờ ngày 12 tháng 4 năm 1985 theo giờ UTC.

1985-04-12T19:20:50.52-04:00 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985, tức là 4 giờ trước giờ UTC (cùng thời điểm với ví dụ trên). Nếu sự kiện diễn ra ở New York, thì thời gian này sẽ tương đương với Giờ ban ngày miền Đông (EDT). Hãy nhớ rằng độ lệch thay đổi tuỳ theo thời gian trong năm ở những khu vực áp dụng Giờ mùa hè (hay Giờ mùa hè).

1985-04-12T19:20:50.52 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985 mà không có thông tin chênh lệch.

Nếu không có thông tin về mức bù trừ, một số tính năng phong phú có thể không hoạt động.

accountId

string

Mã của tài khoản dùng để mua vé.

confirmationCode

string

Mã xác nhận giao dịch mua. Mã này có thể giống nhau cho nhiều phiếu yêu cầu hỗ trợ và được dùng để nhóm các phiếu yêu cầu hỗ trợ lại với nhau.

ticketCost

object (TicketCost)

Giá vé.

TicketCost

Biểu diễn dưới dạng JSON
{
  "faceValue": {
    object (Money)
  },
  "purchasePrice": {
    object (Money)
  },
  "discountMessage": {
    object (LocalizedString)
  }
}
Trường
faceValue

object (Money)

Mệnh giá vé.

purchasePrice

object (Money)

Giá mua thực tế của vé, sau khi trừ thuế và/hoặc chiết khấu.

discountMessage

object (LocalizedString)

Thông báo mô tả mọi loại chiết khấu đã được áp dụng.

TicketLeg

Biểu diễn dưới dạng JSON
{
  "originStationCode": string,
  "originName": {
    object (LocalizedString)
  },
  "destinationStationCode": string,
  "destinationName": {
    object (LocalizedString)
  },
  "departureDateTime": string,
  "arrivalDateTime": string,
  "fareName": {
    object (LocalizedString)
  },
  "carriage": string,
  "platform": string,
  "zone": string,
  "ticketSeat": {
    object (TicketSeat)
  },
  "ticketSeats": [
    {
      object (TicketSeat)
    }
  ],
  "transitOperatorName": {
    object (LocalizedString)
  },
  "transitTerminusName": {
    object (LocalizedString)
  }
}
Trường
originStationCode

string

Mã trạm gốc. Bạn phải có thuộc tính này nếu có destinationStationCode hoặc nếu không có originName.

originName

object (LocalizedString)

Tên của ga xuất phát. Đây là yêu cầu bắt buộc nếu có desinationName hoặc nếu không có originStationCode.

destinationStationCode

string

Mã trạm đích.

destinationName

object (LocalizedString)

Tên đích đến.

departureDateTime

string

Ngày/giờ khởi hành. Đây là yêu cầu bắt buộc nếu bạn chưa đặt khoảng thời gian hợp lệ trên đối tượng chuyển tuyến.

Đây là ngày/giờ ở định dạng mở rộng ISO 8601, có hoặc không có độ lệch. Bạn có thể chỉ định thời gian với độ chính xác lên đến nano giây. Bạn có thể chỉ định độ lệch với độ chính xác đến giây (mặc dù độ lệch giây không thuộc tiêu chuẩn ISO 8601).

Ví dụ:

1985-04-12T23:20:50.52Z sẽ là 20 phút và 50,52 giây sau 23 giờ ngày 12 tháng 4 năm 1985 theo giờ UTC.

1985-04-12T19:20:50.52-04:00 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985, tức là 4 giờ trước giờ UTC (cùng thời điểm với ví dụ trên). Nếu sự kiện diễn ra ở New York, thì thời gian này sẽ tương đương với Giờ ban ngày miền Đông (EDT). Hãy nhớ rằng độ lệch thay đổi tuỳ theo thời gian trong năm ở những khu vực áp dụng Giờ mùa hè (hay Giờ mùa hè).

1985-04-12T19:20:50.52 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985 mà không có thông tin chênh lệch.

Phần ngày/giờ không có độ lệch được coi là "ngày/giờ địa phương". Đây phải là ngày/giờ địa phương tại trạm khởi hành. Ví dụ: nếu chuyến tàu khởi hành lúc 20 giờ ngày 5 tháng 6 năm 2018 tại ga xuất phát, thì phần ngày/giờ theo giờ địa phương phải là 2018-06-05T20:00:00. Nếu ngày/giờ địa phương tại trạm khởi hành 4 giờ trước giờ UTC, thì giá trị chênh lệch của -04:00 có thể được thêm vào.

Nếu không có thông tin chênh lệch, một số tính năng đa dạng thức có thể không hoạt động.

arrivalDateTime

string

Ngày/giờ đến.

Đây là ngày/giờ theo định dạng mở rộng ISO 8601, có hoặc không có giá trị bù trừ. Bạn có thể chỉ định thời gian với độ chính xác lên đến nano giây. Bạn có thể chỉ định độ lệch với độ chính xác đến giây (mặc dù độ lệch giây không thuộc tiêu chuẩn ISO 8601).

Ví dụ:

1985-04-12T23:20:50.52Z sẽ là 20 phút và 50,52 giây sau 23 giờ ngày 12 tháng 4 năm 1985 theo giờ UTC.

1985-04-12T19:20:50.52-04:00 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985, tức là 4 giờ trước giờ UTC (cùng thời điểm với ví dụ trên). Nếu sự kiện diễn ra ở New York, thì thời gian này sẽ tương đương với Giờ ban ngày miền Đông (EDT). Hãy nhớ rằng độ lệch thay đổi tuỳ theo thời gian trong năm ở những khu vực áp dụng Giờ mùa hè (hay Giờ mùa hè).

1985-04-12T19:20:50.52 sẽ là 20 phút và 50,52 giây sau giờ thứ 19 của ngày 12 tháng 4 năm 1985 mà không có thông tin chênh lệch.

Phần ngày/giờ không có độ lệch được coi là "ngày/giờ địa phương". Đây phải là ngày/giờ theo giờ địa phương tại ga đến. Ví dụ: nếu sự kiện xảy ra vào 20 giờ ngày 5 tháng 6 năm 2018 tại ga đến, thì phần ngày/giờ theo giờ địa phương phải là 2018-06-05T20:00:00. Nếu ngày/giờ địa phương tại trạm đích là 4 giờ trước UTC, thì hệ thống có thể thêm độ lệch -04:00.

Nếu không có thông tin chênh lệch, một số tính năng đa dạng thức có thể không hoạt động.

fareName

object (LocalizedString)

Nội dung mô tả ngắn/tên của giá vé cho chặng đi này. Ví dụ: "Sử dụng một lần bất cứ lúc nào".

carriage

string

Tên/số hiệu tàu hoặc xe lửa mà hành khách cần lên.

platform

string

Nền tảng hoặc cổng nơi hành khách có thể lên toa xe.

zone

string

Khu vực lên máy bay trong sân ga.

ticketSeat

object (TicketSeat)

Chỗ ngồi được đặt trước cho (các) hành khách. Nếu bạn cần chỉ định nhiều chỗ ngồi, hãy sử dụng trường ticketSeats. Không thể đặt cả ticketSeatticketSeats.

ticketSeats[]

object (TicketSeat)

Chỗ ngồi được đặt trước cho (các) hành khách. Nếu chỉ cần chỉ định một chỗ ngồi, hãy sử dụng trường ticketSeat. Không thể đặt cả ticketSeatticketSeats.

transitOperatorName

object (LocalizedString)

Tên của nhà vận hành phương tiện công cộng đang vận hành chặng này của chuyến đi.

transitTerminusName

object (LocalizedString)

Ga cuối hoặc điểm đến của tàu/xe buýt/v.v.

TicketSeat

Biểu diễn dưới dạng JSON
{
  "fareClass": enum (FareClass),
  "customFareClass": {
    object (LocalizedString)
  },
  "coach": string,
  "seat": string,
  "seatAssignment": {
    object (LocalizedString)
  }
}
Trường
fareClass

enum (FareClass)

Hạng vé của chỗ ngồi có bán vé.

customFareClass

object (LocalizedString)

Lớp vé tuỳ chỉnh sẽ được sử dụng nếu không có fareClass nào áp dụng. Không thể đặt cả fareClasscustomFareClass.

coach

string

Giá trị nhận dạng của toa xe hoặc toa xe khách nơi có ghế được đặt vé. Ví dụ: "10"

seat

string

Giá trị nhận dạng vị trí của chỗ ngồi đã mua vé. Ví dụ: "42". Nếu không có giá trị nhận dạng cụ thể, hãy sử dụng seatAssigment.

seatAssignment

object (LocalizedString)

Ghế ngồi cho hành khách. Ví dụ: "không có chỗ ngồi cụ thể". Dùng khi không có giá trị nhận dạng cụ thể để sử dụng trong seat.

FareClass

Enum
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

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

FIRST
first

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

BUSINESS
business

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

TripType

Enum
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

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

ONE_WAY
oneWay

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

ActivationStatus

Trạng thái kích hoạt của đối tượng. Trường này bao gồm trạng thái kích hoạt nếu giá trị hỗ trợ kích hoạt.

Biểu diễn dưới dạng JSON
{
  "state": enum (State)
}
Trường
state

enum (State)

Tiểu bang

Enum
UNKNOWN_STATE
NOT_ACTIVATED Chưa kích hoạt, đây là trạng thái mặc định
not_activated

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

ACTIVATED Kích hoạt
activated

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

DeviceContext

Ngữ cảnh thiết bị liên kết với đối tượng.

Biểu diễn dưới dạng JSON
{
  "deviceToken": string
}
Trường
deviceToken

string

Nếu được đặt, thông tin sử dụng mã sẽ chỉ được trả về cho thiết bị đã cho khi kích hoạt đối tượng. Bạn không nên sử dụng giá trị này làm giá trị nhận dạng ổn định để theo dõi thiết bị của người dùng. Mã này có thể thay đổi giữa các thẻ/vé cho cùng một thiết bị hoặc thậm chí giữa các lần kích hoạt cho cùng một thiết bị. Khi đặt giá trị này, phương thức gọi cũng phải đặt hasLinkedDevice trên đối tượng đang được kích hoạt.

Phương thức

addmessage

Thêm thông báo vào đối tượng phương tiện công cộng được tham chiếu bằng mã nhận dạng đối tượng đã cho.

get

Trả về đối tượng phương tiện công cộng có mã nhận dạng đối tượng đã cho.

insert

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

list

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

patch

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

update

Cập nhật đối tượng phương tiện công cộng được tham chiếu bằng mã đối tượng đã cho.