REST Resource: transitobject

ทรัพยากร: TransitObject

การแสดง 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)
  }
}
ช่อง
classReference

object (TransitClass)

สำเนาของช่องที่รับค่ามาจากคลาสระดับบนสุด ระบบจะดึงข้อมูลช่องเหล่านี้ขึ้นมาระหว่าง GET
ticketNumber

string

หมายเลขตั๋ว เมตริกนี้คือตัวระบุที่ไม่ซ้ำกันสำหรับตั๋วในระบบของผู้ให้บริการขนส่งสาธารณะ
passengerType

enum (PassengerType)

จำนวนผู้โดยสาร
passengerNames

string

ชื่อของผู้โดยสารที่ได้รับมอบหมายตั๋ว ช่อง passengerType ด้านบนมีไว้เพื่อให้บริบทกับ Google ในช่องนี้
tripId

string

รหัสนี้ใช้เพื่อจัดกลุ่มตั๋วไว้ด้วยกันหากผู้ใช้บันทึกตั๋วหลายใบสำหรับการเดินทางเดียวกัน
ticketStatus

enum (TicketStatus)

สถานะของคำขอแจ้งปัญหา สำหรับสถานะที่ส่งผลต่อการแสดงผล ให้ใช้ช่อง state แทน
customTicketStatus

object (LocalizedString)

สถานะที่กำหนดเองเพื่อใช้กับค่าสถานะของตั๋วเมื่อ ticketStatus ไม่ได้ให้ตัวเลือกที่เหมาะสม ตั้งค่าทั้ง ticketStatus และ customTicketStatus ไม่ได้
concessionCategory

enum (ConcessionCategory)

หมวดหมู่ตั๋วราคาพิเศษ
customConcessionCategory

object (LocalizedString)

หมวดหมู่ตั๋วราคาพิเศษที่กำหนดเองซึ่งจะใช้เมื่อ concessionCategory ไม่มีตัวเลือกที่เหมาะสม ตั้งค่าทั้ง concessionCategory และ customConcessionCategory ไม่ได้
ticketRestrictions

object (TicketRestrictions)

ข้อมูลเกี่ยวกับประเภทของข้อจำกัดในการใช้คำขอแจ้งปัญหานี้ ตัวอย่างเช่น ต้องใช้วันใดของสัปดาห์ หรือเส้นทางที่อนุญาตให้ใช้ได้
purchaseDetails

object (PurchaseDetails)

รายละเอียดการซื้อสำหรับตั๋วนี้
ticketLeg

object (TicketLeg)

ตั๋วเที่ยวเดียวมีข้อมูลเวลาออกเดินทางและการมาถึง พร้อมด้วยข้อมูลการขึ้นเครื่องและที่นั่ง หากระบุขามากกว่า 1 ขา ให้ใช้ช่อง ticketLegs แทน ตั้งค่าทั้ง ticketLeg และ ticketLegs ไม่ได้
ticketLegs[]

object (TicketLeg)

ตั๋วแต่ละใบสามารถมีขาได้อย่างน้อย 1 ขา แต่ละรอบจะมีข้อมูลเวลาออกเดินทางและการมาถึง พร้อมทั้งข้อมูลการขึ้นเครื่องและที่นั่ง หากระบุขาเดียว ให้ใช้ช่อง ticketLeg แทน ตั้งค่าทั้ง ticketLeg และ ticketLegs ไม่ได้
hexBackgroundColor

string

สีพื้นหลังของการ์ด หากไม่ได้กำหนดสีที่โดดเด่นของรูปภาพหลัก และหากไม่ได้ตั้งค่ารูปภาพหลัก ระบบจะใช้สีที่โดดเด่นของโลโก้ รูปแบบคือ #rrggbb โดยที่ rrggbb เป็น 3 แบบ RGB แบบเลขฐาน 16 เช่น #ffcc00 คุณยังใช้ 3 เวอร์ชันย่อของ RGB ซึ่งก็คือ #rgb ได้ เช่น #fc0
tripType

enum (TripType)

ต้องระบุ ประเภทของการเดินทางที่ออบเจ็กต์ขนส่งสาธารณะนี้แสดง ใช้ระบุชื่อบัตรและ/หรือสัญลักษณ์ที่จะใช้ระหว่างต้นทางและจุดหมาย
id

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับออบเจ็กต์ รหัสนี้ต้องไม่ซ้ำกันในทุกออบเจ็กต์จากผู้ออกบัตร ค่านี้ควรเป็นไปตามรูปแบบ issuer IDidentifier โดยที่ Google เป็นผู้ออกนโยบายเก่าและคุณเป็นผู้เลือกรายการหลัง ตัวระบุที่ไม่ซ้ำกันควรมีเฉพาะอักขระที่เป็นตัวอักษรและตัวเลขคละกัน, ".", "_" หรือ "-" เท่านั้น
classId

string

ต้องระบุ คลาสที่เชื่อมโยงกับออบเจ็กต์นี้ คลาสต้องเป็นประเภทเดียวกับออบเจ็กต์นี้ ต้องมีอยู่แล้วและต้องได้รับอนุมัติ

รหัสชั้นเรียนควรเป็นไปตามรูปแบบ issuer IDidentifier โดยที่ 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

ระบุว่าควรระงับการแจ้งเตือนอย่างชัดแจ้งหรือไม่ หากตั้งค่าช่องนี้เป็น "จริง" ไม่ว่าช่อง messages จะเป็นช่องใดก็ตาม ระบบจะระงับการแจ้งเตือนการหมดอายุของผู้ใช้ ระบบจะตั้งค่าช่องนี้เป็น "เท็จ" โดยค่าเริ่มต้น

ปัจจุบันตั้งค่านี้ได้สำหรับข้อเสนอเท่านั้น
infoModuleData

object (InfoModuleData)

เลิกใช้งานแล้ว โปรดใช้ textModulesData แทน
imageModulesData[]

object (ImageModuleData)

ข้อมูลโมดูลรูปภาพ จำนวนสูงสุดของช่องที่แสดงเหล่านี้คือ 1 ช่องจากระดับออบเจ็กต์ และ 1 ช่องสำหรับระดับออบเจ็กต์คลาส
textModulesData[]

object (TextModuleData)

ข้อมูลโมดูลข้อความ หากมีการกำหนดข้อมูลโมดูลข้อความไว้ในคลาสด้วย ระบบจะแสดงทั้ง 2 รายการ โดยจำนวนสูงสุดของช่องที่แสดงคือ 10 ช่องจากออบเจ็กต์ และ 10 ช่องจากคลาส
activationStatus

object (ActivationStatus)

สถานะการเปิดใช้งานของออบเจ็กต์ ต้องระบุหากชั้นเรียนตั้งค่าactivationOptionsไว้
rotatingBarcode

object (RotatingBarcode)

ประเภทและค่าบาร์โค้ดแบบหมุน
deviceContext

object (DeviceContext)

บริบทอุปกรณ์ที่เชื่อมโยงกับออบเจ็กต์
heroImage

object (Image)

รูปภาพแบนเนอร์ที่ไม่บังคับจะแสดงที่ด้านหน้าการ์ด หากไม่มี ระบบจะแสดงรูปภาพหลักของชั้นเรียน (หากมี) หากไม่มีรูปภาพหลักของชั้นเรียนด้วย ก็จะไม่มีรูปภาพใดๆ ปรากฏขึ้น
groupingInfo

object (GroupingInfo)

ข้อมูลที่ควบคุมวิธีจัดกลุ่มบัตรเข้าด้วยกัน
passConstraints

object (PassConstraints)

ส่งผ่านข้อจำกัดสำหรับออบเจ็กต์ รวมถึงการจำกัดการทำงานของ NFC และภาพหน้าจอ

PassengerType

Enum
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

ชื่อแทนเดิมสำหรับ SINGLE_PASSENGER เลิกใช้งานแล้ว
MULTIPLE_PASSENGERS
multiplePassengers

ชื่อแทนเดิมสำหรับ MULTIPLE_PASSENGERS เลิกใช้งานแล้ว

TicketStatus

Enum
TICKET_STATUS_UNSPECIFIED
USED
used

ชื่อแทนเดิมสำหรับ USED เลิกใช้งานแล้ว
REFUNDED
refunded

ชื่อแทนเดิมสำหรับ REFUNDED เลิกใช้งานแล้ว
EXCHANGED
exchanged

ชื่อแทนเดิมสำหรับ EXCHANGED เลิกใช้งานแล้ว

ConcessionCategory

Enum
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

ชื่อแทนเดิมสำหรับ ADULT เลิกใช้งานแล้ว
CHILD
child

ชื่อแทนเดิมสำหรับ CHILD เลิกใช้งานแล้ว
SENIOR
senior

ชื่อแทนเดิมสำหรับ SENIOR เลิกใช้งานแล้ว

TicketRestrictions

การแสดง JSON 
{
  "routeRestrictions": {
    object (LocalizedString)
  },
  "routeRestrictionsDetails": {
    object (LocalizedString)
  },
  "timeRestrictions": {
    object (LocalizedString)
  },
  "otherRestrictions": {
    object (LocalizedString)
  }
}
ช่อง
routeRestrictions

object (LocalizedString)

ข้อจำกัดเกี่ยวกับเส้นทางที่อาจใช้ ตัวอย่างเช่น อาจเป็นสตริง "รถไฟข้ามประเทศที่จองไว้เท่านั้น"
routeRestrictionsDetails

object (LocalizedString)

รายละเอียดเพิ่มเติมเกี่ยวกับrouteRestrictionsข้างต้น
timeRestrictions

object (LocalizedString)

ข้อจำกัดเกี่ยวกับเวลาในการใช้ตั๋วใบนี้
otherRestrictions

object (LocalizedString)

ข้อจำกัดเพิ่มเติมที่ไม่อยู่ในหมวดหมู่ "เส้นทาง" หรือ "เวลา"

PurchaseDetails

การแสดง JSON 
{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object (TicketCost)
  }
}
ช่อง
purchaseReceiptNumber

string

หมายเลขใบเสร็จ/ตัวระบุสำหรับติดตามการซื้อตั๋วผ่านทางหน่วยงานที่จำหน่ายตั๋ว
purchaseDateTime

string

วัน/เวลาที่ซื้อตั๋ว

วันที่/เวลาสำหรับรูปแบบแบบขยายของ ISO 8601 จะมีหรือไม่มีออฟเซ็ต สามารถระบุเวลาได้แม่นยำถึงระดับนาโนวินาที คุณสามารถระบุออฟเซ็ตได้ด้วยความแม่นยําของวินาที (แม้ว่าออฟเซ็ตวินาทีจะไม่ใช่ส่วนหนึ่งของ ISO 8601)

เช่น

1985-04-12T23:20:50.52Z จะเป็น 20 นาทีและ 50.52 วินาทีหลังจากชั่วโมงที่ 23 ของวันที่ 12 เมษายน 1985 ในเขตเวลา UTC

1985-04-12T19:20:50.52-04:00 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 และ 4 ชั่วโมงก่อนเวลา UTC (เป็นนาทีเดียวกับตัวอย่างด้านบน) หากเหตุการณ์เกิดขึ้นในนิวยอร์ก ค่านี้จะเทียบเท่ากับเวลาออมแสงตะวันออก (EDT) โปรดทราบว่าการชดเชยจะแตกต่างกันไปในภูมิภาคที่ใช้เวลาออมแสง (หรือเวลาในฤดูร้อน) โดยจะขึ้นอยู่กับช่วงเวลาของปี

1985-04-12T19:20:50.52 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 โดยไม่มีข้อมูลออฟเซ็ต

หากไม่มีข้อมูลออฟเซ็ต ฟีเจอร์แบบสมบูรณ์บางอย่างอาจไม่พร้อมใช้งาน
accountId

string

รหัสบัญชีที่ใช้ซื้อตั๋ว
confirmationCode

string

รหัสยืนยันสำหรับการซื้อ ซึ่งอาจเหมือนกันสำหรับตั๋วหลายใบและใช้เพื่อจัดกลุ่มตั๋วเข้าด้วยกัน
ticketCost

object (TicketCost)

ค่าตั๋ว

TicketCost

การแสดง JSON 
{
  "faceValue": {
    object (Money)
  },
  "purchasePrice": {
    object (Money)
  },
  "discountMessage": {
    object (LocalizedString)
  }
}
ช่อง
faceValue

object (Money)

ราคาหน้าบัตร
purchasePrice

object (Money)

ราคาซื้อจริงของตั๋ว หลังหักภาษีและ/หรือส่วนลด
discountMessage

object (LocalizedString)

ข้อความอธิบายส่วนลดที่ใช้

TicketLeg

การแสดง 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)
  }
}
ช่อง
originStationCode

string

รหัสสถานีต้นทาง ซึ่งจำเป็นต้องดำเนินการหากมี destinationStationCode อยู่หรือ originName ไม่มีอยู่
originName

object (LocalizedString)

ชื่อของสถานีต้นทาง ซึ่งจำเป็นต้องดำเนินการหากมี desinationName อยู่หรือ originStationCode ไม่มีอยู่
destinationStationCode

string

รหัสสถานีปลายทาง
destinationName

object (LocalizedString)

ชื่อปลายทาง
departureDateTime

string

วันที่/เวลาออกเดินทาง คุณจำเป็นต้องดำเนินการนี้หากไม่ได้ตั้งค่าช่วงเวลาที่ถูกต้องในออบเจ็กต์การขนส่ง

วันที่/เวลาสำหรับรูปแบบแบบขยายของ ISO 8601 จะมีหรือไม่มีออฟเซ็ต สามารถระบุเวลาได้แม่นยำถึงระดับนาโนวินาที คุณสามารถระบุออฟเซ็ตได้ด้วยความแม่นยําของวินาที (แม้ว่าออฟเซ็ตวินาทีจะไม่ใช่ส่วนหนึ่งของ ISO 8601)

เช่น

1985-04-12T23:20:50.52Z จะเป็น 20 นาทีและ 50.52 วินาทีหลังจากชั่วโมงที่ 23 ของวันที่ 12 เมษายน 1985 ในเขตเวลา UTC

1985-04-12T19:20:50.52-04:00 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 และ 4 ชั่วโมงก่อนเวลา UTC (เป็นนาทีเดียวกับตัวอย่างด้านบน) หากเหตุการณ์เกิดขึ้นในนิวยอร์ก ค่านี้จะเทียบเท่ากับเวลาออมแสงตะวันออก (EDT) โปรดทราบว่าการชดเชยจะแตกต่างกันไปในภูมิภาคที่ใช้เวลาออมแสง (หรือเวลาในฤดูร้อน) โดยจะขึ้นอยู่กับช่วงเวลาของปี

1985-04-12T19:20:50.52 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 โดยไม่มีข้อมูลออฟเซ็ต

ส่วนของวันที่/เวลาที่ไม่มีการชดเชยจะถือว่าเป็น "วันที่/เวลาท้องถิ่น" ซึ่งควรเป็นวันที่/เวลาท้องถิ่นที่สถานีต้นทาง ตัวอย่างเช่น หากเวลาออกเดินทางเกิดขึ้นในชั่วโมงที่ 20 ของวันที่ 5 มิถุนายน 2018 ที่สถานีต้นทาง ส่วนวันที่/เวลาท้องถิ่นควรเป็น 2018-06-05T20:00:00 หากวันที่/เวลาท้องถิ่นที่สถานีต้นทางอยู่ 4 ชั่วโมงก่อนเวลา UTC ระบบอาจเพิ่มการชดเชย -04:00 ต่อท้าย

หากไม่มีข้อมูลออฟเซ็ต ฟีเจอร์แบบสมบูรณ์บางอย่างอาจไม่พร้อมใช้งาน
arrivalDateTime

string

วันที่/เวลาที่มาถึง

วันที่/เวลาสำหรับรูปแบบแบบขยายของ ISO 8601 จะมีหรือไม่มีออฟเซ็ต สามารถระบุเวลาได้แม่นยำถึงระดับนาโนวินาที คุณสามารถระบุออฟเซ็ตได้ด้วยความแม่นยําของวินาที (แม้ว่าออฟเซ็ตวินาทีจะไม่ใช่ส่วนหนึ่งของ ISO 8601)

เช่น

1985-04-12T23:20:50.52Z จะเป็น 20 นาทีและ 50.52 วินาทีหลังจากชั่วโมงที่ 23 ของวันที่ 12 เมษายน 1985 ในเขตเวลา UTC

1985-04-12T19:20:50.52-04:00 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 และ 4 ชั่วโมงก่อนเวลา UTC (เป็นนาทีเดียวกับตัวอย่างด้านบน) หากเหตุการณ์เกิดขึ้นในนิวยอร์ก ค่านี้จะเทียบเท่ากับเวลาออมแสงตะวันออก (EDT) โปรดทราบว่าการชดเชยจะแตกต่างกันไปในภูมิภาคที่ใช้เวลาออมแสง (หรือเวลาในฤดูร้อน) โดยจะขึ้นอยู่กับช่วงเวลาของปี

1985-04-12T19:20:50.52 จะเป็น 20 นาทีและ 50.52 วินาทีหลังจาก 19 ชั่วโมงของวันที่ 12 เมษายน 1985 โดยไม่มีข้อมูลออฟเซ็ต

ส่วนของวันที่/เวลาที่ไม่มีการชดเชยจะถือว่าเป็น "วันที่/เวลาท้องถิ่น" ซึ่งควรเป็นวันที่/เวลาท้องถิ่นที่สถานีปลายทาง ตัวอย่างเช่น หากกิจกรรมเกิดขึ้นในชั่วโมงที่ 20 ของวันที่ 5 มิถุนายน 2018 ที่สถานีปลายทาง ส่วนวันที่/เวลาท้องถิ่นควรเป็น 2018-06-05T20:00:00 หากวันที่/เวลาท้องถิ่นที่สถานีปลายทางคือ 4 ชั่วโมงก่อนเวลา UTC ระบบอาจเพิ่มการชดเชย -04:00 ต่อท้าย

หากไม่มีข้อมูลออฟเซ็ต ฟีเจอร์แบบสมบูรณ์บางอย่างอาจไม่พร้อมใช้งาน
fareName

object (LocalizedString)

คำอธิบาย/ชื่อค่าโดยสารสั้นๆ สำหรับการเดินทางครั้งนี้ เช่น "ใช้ครั้งเดียวได้ทุกเมื่อ"
carriage

string

ชื่อ/หมายเลขรถไฟหรือเรือที่ผู้โดยสารต้องขึ้นเครื่อง
platform

string

ชานชาลาหรือประตูที่ผู้โดยสารขึ้นรถได้
zone

string

โซนการขึ้นเครื่องภายในแพลตฟอร์ม
ticketSeat

object (TicketSeat)

ที่นั่งที่จองไว้สำหรับผู้โดยสาร หากต้องการระบุที่นั่งมากกว่า 1 ที่ ให้ใช้ช่อง ticketSeats แทน ตั้งค่าทั้ง ticketSeat และ ticketSeats ไม่ได้
ticketSeats[]

object (TicketSeat)

ที่นั่งที่จองไว้สำหรับผู้โดยสาร หากระบุที่นั่งเพียงรายการเดียว ให้ใช้ช่อง ticketSeat แทน ตั้งค่าทั้ง ticketSeat และ ticketSeats ไม่ได้
transitOperatorName

object (LocalizedString)

ชื่อของผู้ให้บริการขนส่งที่ดำเนินการเดินทางนี้
transitTerminusName

object (LocalizedString)

สถานีปลายทางหรือปลายทางของรถไฟ/รถประจำทาง/อื่นๆ

TicketSeat

การแสดง JSON 
{
  "fareClass": enum (FareClass),
  "customFareClass": {
    object (LocalizedString)
  },
  "coach": string,
  "seat": string,
  "seatAssignment": {
    object (LocalizedString)
  }
}
ช่อง
fareClass

enum (FareClass)

ระดับค่าโดยสารของที่นั่งที่จำหน่ายตั๋ว
customFareClass

object (LocalizedString)

ชั้นค่าโดยสารที่กำหนดเองที่จะใช้หากไม่มี fareClass ตั้งค่าทั้ง fareClass และ customFareClass ไม่ได้
coach

string

ตัวระบุของรถไฟหรือรถบัสที่มีที่นั่งจำหน่ายตั๋ว เช่น "10"
seat

string

ตัวระบุตำแหน่งของที่นั่งที่จำหน่ายตั๋ว เช่น "42" หากไม่มีตัวระบุที่เฉพาะเจาะจง ให้ใช้ seatAssigment แทน
seatAssignment

object (LocalizedString)

การกำหนดที่นั่งของผู้โดยสาร เช่น "ไม่มีที่นั่งที่เจาะจง" ใช้เมื่อไม่มีตัวระบุเฉพาะที่จะใช้ใน seat

FareClass

Enum
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

ชื่อแทนเดิมสำหรับ ECONOMY เลิกใช้งานแล้ว
FIRST
first

ชื่อแทนเดิมสำหรับ FIRST เลิกใช้งานแล้ว
BUSINESS
business

ชื่อแทนเดิมสำหรับ BUSINESS เลิกใช้งานแล้ว

TripType

Enum
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

ชื่อแทนเดิมสำหรับ ROUND_TRIP เลิกใช้งานแล้ว
ONE_WAY
oneWay

ชื่อแทนเดิมสำหรับ ONE_WAY เลิกใช้งานแล้ว

ActivationStatus

สถานะการเปิดใช้งานของออบเจ็กต์ ช่องนี้จะมีสถานะการเปิดใช้งานหากมีค่าที่รองรับการเปิดใช้งาน

การแสดง JSON 
{
  "state": enum (State)
}
ช่อง
state

enum (State)

รัฐ

Enum
UNKNOWN_STATE
NOT_ACTIVATED ไม่ได้เปิดใช้งาน นี่คือสถานะเริ่มต้น
not_activated

ชื่อแทนเดิมสำหรับ NOT_ACTIVATED เลิกใช้งานแล้ว
ACTIVATED เปิดใช้งานอยู่
activated

ชื่อแทนเดิมสำหรับ ACTIVATED เลิกใช้งานแล้ว

DeviceContext

บริบทอุปกรณ์ที่เชื่อมโยงกับออบเจ็กต์

การแสดง JSON 
{
  "deviceToken": string
}
ช่อง
deviceToken

string

หากตั้งค่าไว้ ระบบจะส่งข้อมูลการแลกสิทธิ์ไปยังอุปกรณ์ที่ระบุเมื่อเปิดใช้งานออบเจ็กต์เท่านั้น ไม่ควรใช้ค่านี้เป็นตัวระบุแบบคงที่เพื่อติดตามอุปกรณ์ของผู้ใช้ ซึ่งอาจเปลี่ยนแปลงได้ข้ามบัตรต่างๆ สำหรับอุปกรณ์เดียวกัน หรือแม้กระทั่งการเปิดใช้งานหลายครั้งสำหรับอุปกรณ์เดียวกัน เมื่อใช้การตั้งค่านี้ ผู้โทรต้องตั้งค่า hasLinkedDevice ในออบเจ็กต์ที่เปิดใช้งานด้วย

วิธีการ

addmessage

 เพิ่มข้อความลงในออบเจ็กต์การส่งที่อ้างอิงตามรหัสออบเจ็กต์ที่ระบุ

get

 แสดงผลออบเจ็กต์แผนการเดินทางที่มีรหัสออบเจ็กต์ที่ระบุ

insert

 แทรกออบเจ็กต์การส่งที่มีรหัสและพร็อพเพอร์ตี้ที่ระบุ

list

 แสดงรายการออบเจ็กต์แผนการเดินทางทั้งหมดสำหรับรหัสผู้ออกบัตรที่ระบุ

patch

 อัปเดตออบเจ็กต์การรับส่งที่อ้างอิงตามรหัสออบเจ็กต์ที่ระบุ

update

 อัปเดตออบเจ็กต์การรับส่งที่อ้างอิงตามรหัสออบเจ็กต์ที่ระบุ