REST Resource: transitclass

ทรัพยากร: TransitClass

การแสดง JSON 
{
  "transitOperatorName": {
    object (LocalizedString)
  },
  "logo": {
    object (Image)
  },
  "transitType": enum (TransitType),
  "watermark": {
    object (Image)
  },
  "languageOverride": string,
  "customTransitTerminusNameLabel": {
    object (LocalizedString)
  },
  "customTicketNumberLabel": {
    object (LocalizedString)
  },
  "customRouteRestrictionsLabel": {
    object (LocalizedString)
  },
  "customRouteRestrictionsDetailsLabel": {
    object (LocalizedString)
  },
  "customTimeRestrictionsLabel": {
    object (LocalizedString)
  },
  "customOtherRestrictionsLabel": {
    object (LocalizedString)
  },
  "customPurchaseReceiptNumberLabel": {
    object (LocalizedString)
  },
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "customPurchaseFaceValueLabel": {
    object (LocalizedString)
  },
  "customPurchasePriceLabel": {
    object (LocalizedString)
  },
  "customDiscountMessageLabel": {
    object (LocalizedString)
  },
  "customCarriageLabel": {
    object (LocalizedString)
  },
  "customSeatLabel": {
    object (LocalizedString)
  },
  "customCoachLabel": {
    object (LocalizedString)
  },
  "customPlatformLabel": {
    object (LocalizedString)
  },
  "customZoneLabel": {
    object (LocalizedString)
  },
  "customFareClassLabel": {
    object (LocalizedString)
  },
  "customConcessionCategoryLabel": {
    object (LocalizedString)
  },
  "customFareNameLabel": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "enableSingleLegItinerary": boolean,
  "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)
  },
  "activationOptions": {
    object (ActivationOptions)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
ช่อง
transitOperatorName

object (LocalizedString)

ชื่อผู้ให้บริการขนส่งสาธารณะ
transitType

enum (TransitType)

ต้องระบุ ประเภทขนส่งสาธารณะที่คลาสนี้แสดง เช่น "รถประจำทาง"
watermark

object (Image)

รูปภาพลายน้ำที่จะแสดงในอุปกรณ์ของผู้ใช้
languageOverride

string

หากมีฟิลด์นี้ ตั๋วโดยสารที่แสดงในอุปกรณ์ของผู้ใช้จะเป็นภาษานี้เสมอ แสดงแท็กภาษา BCP 47 ตัวอย่างค่า ได้แก่ "en-US", "en-GB", "de" หรือ "de-AT"
customTransitTerminusNameLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าชื่อสถานีปลายทาง (transitObject.ticketLeg.transitTerminusName)
customTicketNumberLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าหมายเลขคำขอแจ้งปัญหา (transitObject.ticketNumber)
customRouteRestrictionsLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าข้อจํากัดด้านเส้นทาง (transitObject.ticketRestrictions.routeRestrictions)
customRouteRestrictionsDetailsLabel

object (LocalizedString)

ป้ายกำกับที่กำหนดเองเพื่อใช้กับค่ารายละเอียดข้อจำกัดด้านเส้นทาง (transitObject.ticketRestrictions.routeRestrictionsDetails)
customTimeRestrictionsLabel

object (LocalizedString)

ป้ายกำกับที่กำหนดเองเพื่อใช้กับค่ารายละเอียดข้อจำกัดด้านเวลา (transitObject.ticketRestrictions.timeRestrictions)
customOtherRestrictionsLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าข้อจํากัดอื่นๆ (transitObject.ticketRestrictions.otherRestrictions)
customPurchaseReceiptNumberLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าหมายเลขใบเสร็จการซื้อ (transitObject.purchaseDetails.purchaseReceiptNumber)
customConfirmationCodeLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่ารหัสยืนยัน (transitObject.purchaseDetails.confirmationCode)
customPurchaseFaceValueLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับราคาซื้อหน้าตั๋ว (transitObject.purchaseDetails.ticketCost.faceValue)
customPurchasePriceLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าราคาซื้อ (transitObject.purchaseDetails.ticketCost.purchasePrice)
customDiscountMessageLabel

object (LocalizedString)

ป้ายกำกับที่กำหนดเองเพื่อใช้กับค่าข้อความส่วนลดสำหรับขนส่งสาธารณะ (transitObject.purchaseDetails.ticketCost.discountMessage)
customCarriageLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าการนําส่ง (transitObject.ticketLeg.carriage)
customSeatLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าตําแหน่งที่นั่ง (transitObject.ticketLeg.ticketSeat.seat)
customCoachLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าโค้ช (transitObject.ticketLeg.ticketSeat.coach)
customPlatformLabel

object (LocalizedString)

ป้ายกำกับที่กำหนดเองเพื่อใช้กับค่าชานชาลาขึ้น (transitObject.ticketLeg.platform)
customZoneLabel

object (LocalizedString)

ป้ายกำกับที่กำหนดเองเพื่อใช้กับค่าโซนขึ้นเครื่อง (transitObject.ticketLeg.zone)
customFareClassLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าชั้นโดยสาร (transitObject.ticketLeg.ticketSeat.fareClass)
customConcessionCategoryLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าหมวดหมู่ส่วนลดค่าโดยสาร (transitObject.concessionCategory)
customFareNameLabel

object (LocalizedString)

ป้ายกํากับที่กําหนดเองเพื่อใช้กับค่าชื่อค่าโดยสารขนส่งสาธารณะ (transitObject.ticketLeg.fareName)
classTemplateInfo

object (ClassTemplateInfo)

ข้อมูลเทมเพลตเกี่ยวกับวิธีแสดงชั้นเรียน หากไม่ได้ตั้งค่าไว้ Google จะแสดงชุดช่องเริ่มต้น
enableSingleLegItinerary

boolean

ควบคุมการแสดงแผนการเดินทางเที่ยวเดียวสำหรับชั้นเรียนนี้ โดยค่าเริ่มต้น แผนการเดินทางจะแสดงเฉพาะสำหรับการเดินทางหลายเที่ยว
id

string

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

string (int64 format)

เลิกใช้
issuerName

string

ต้องระบุ ชื่อผู้ออกบัตร ความยาวสูงสุดที่แนะนำคือ 20 อักขระเพื่อให้สตริงแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก
messages[]

object (Message)

อาร์เรย์ข้อความที่แสดงในแอป ผู้ใช้ทั้งหมดของออบเจ็กต์นี้จะได้รับข้อความที่เกี่ยวข้อง จํานวนสูงสุดของช่องเหล่านี้คือ 10 ช่อง
allowMultipleUsersPerObject
(deprecated)

boolean

เลิกใช้งานแล้ว ให้ใช้ multipleDevicesAndHoldersAllowedStatus แทน
homepageUri

object (Uri)

URI ของหน้าแรกของแอปพลิเคชัน การป้อนข้อมูล URI ในช่องนี้จะทําให้มีลักษณะการทำงานเหมือนกับการป้อนข้อมูล URI ใน linksModuleData (เมื่อแสดงผลออบเจ็กต์ ลิงก์ไปยังหน้าแรกจะแสดงในส่วนที่มักเรียกว่าส่วน linksModuleData ของออบเจ็กต์)
locations[]
(deprecated)

object (LatLongPoint)

หมายเหตุ: ปัจจุบันระบบยังไม่รองรับการใช้ฟิลด์นี้เพื่อทริกเกอร์การแจ้งเตือนตามภูมิศาสตร์
reviewStatus

enum (ReviewStatus)

ต้องระบุ สถานะของชั้นเรียน ช่องนี้สามารถตั้งค่าเป็น draft หรือ underReview โดยใช้การเรียก API ของแทรก แก้ไข หรืออัปเดต เมื่อสถานะการตรวจสอบเปลี่ยนจาก draft แล้ว คุณจะเปลี่ยนกลับไปเป็น draft ไม่ได้

คุณควรตั้งค่าฟิลด์นี้เป็น draft เมื่อชั้นเรียนอยู่ระหว่างการพัฒนา คุณใช้คลาส draft เพื่อสร้างออบเจ็กต์ไม่ได้

คุณควรตั้งค่าช่องนี้เป็น underReview เมื่อเชื่อว่าชั้นเรียนพร้อมใช้งาน แพลตฟอร์มจะตั้งค่าช่องนี้เป็น approved โดยอัตโนมัติ และสามารถใช้เพื่อสร้างหรือย้ายข้อมูลออบเจ็กต์ได้ทันที

เมื่ออัปเดตคลาส approved อยู่แล้ว คุณควรตั้งค่าช่องนี้เป็น underReview ต่อไป
review

object (Review)

ความคิดเห็นรีวิวที่แพลตฟอร์มตั้งค่าไว้เมื่อมีการทําเครื่องหมายชั้นเรียนเป็น approved หรือ rejected
infoModuleData
(deprecated)

object (InfoModuleData)

เลิกใช้งานแล้ว ให้ใช้ textModulesData แทน
imageModulesData[]

object (ImageModuleData)

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

object (TextModuleData)

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

string (int64 format)

ระบุผู้ออกบัตรแลกสิทธิ์ที่แลกแต้มผ่าน Smart Tap ได้ ระบบจะระบุผู้ออกบัตรแลกสิทธิ์ด้วยรหัสผู้ออกบัตร ผู้ออกบัตรแลกสิทธิ์ต้องกำหนดค่าคีย์ Smart Tap อย่างน้อย 1 รายการ

นอกจากนี้ คุณต้องตั้งค่าช่อง enableSmartTap และsmartTapRedemptionLevel ระดับออบเจ็กต์อย่างถูกต้องเพื่อให้บัตรรองรับการแตะอัจฉริยะ
countryCode

string

รหัสประเทศที่ใช้แสดงประเทศของการ์ด (เมื่อผู้ใช้ไม่ได้อยู่ในประเทศนั้น) รวมถึงแสดงเนื้อหาที่แปลแล้วเมื่อเนื้อหาไม่พร้อมใช้งานในภาษาของผู้ใช้
heroImage

object (Image)

รูปภาพแบนเนอร์ (ไม่บังคับ) ที่แสดงที่ด้านหน้าของการ์ด หากไม่มี จะไม่มีการแสดงข้อมูลใดๆ รูปภาพจะแสดงที่ความกว้าง 100%
wordMark
(deprecated)

object (Image)

เลิกใช้งานแล้ว
enableSmartTap

boolean

ระบุว่าคลาสนี้รองรับการแตะอัจฉริยะหรือไม่ นอกจากนี้ คุณต้องตั้งค่าช่อง redemptionIssuers และsmartTapRedemptionLevel ระดับออบเจ็กต์อย่างถูกต้องเพื่อให้บัตรรองรับการแตะอัจฉริยะ
hexBackgroundColor

string

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

object (LocalizedString)

สตริงที่แปลแล้วสำหรับ issuerName ความยาวสูงสุดที่แนะนำคือ 20 อักขระเพื่อให้สตริงแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก
multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

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

object (CallbackOptions)

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

object (SecurityAnimation)

ข้อมูลเกี่ยวกับภาพเคลื่อนไหวเกี่ยวกับความปลอดภัย (ไม่บังคับ) หากตั้งค่านี้ ระบบจะแสดงภาพเคลื่อนไหวความปลอดภัยในรายละเอียดบัตร
activationOptions

object (ActivationOptions)

ตัวเลือกการเปิดใช้งานสำหรับตั๋วที่เปิดใช้งานได้
viewUnlockRequirement

enum (ViewUnlockRequirement)

ดูตัวเลือกข้อกำหนดการปลดล็อกสำหรับตั๋วขนส่งสาธารณะ
notifyPreference

enum (NotificationSettingsForUpdates)

การตั้งค่าว่าควรมีการแจ้งเตือนเมื่อมีการอัปเดตช่องในชั้นเรียนนี้หรือไม่ เมื่อตั้งค่าเป็น "แจ้งเตือน" เราจะพยายามเรียกให้ระบบแจ้งเตือนการอัปเดตช่องแก่ผู้ใช้ ระบบจะส่งการแจ้งเตือนเหล่านี้ไปยังผู้ใช้ก็ต่อเมื่อช่องเป็นส่วนหนึ่งของรายการที่อนุญาตเท่านั้น หากตั้งค่าเป็น DO_NOT_NOTIFY หรือ NOTIFICATION_SETTINGS_UNSPECIFIED ระบบจะไม่ทริกเกอร์การแจ้งเตือน การตั้งค่านี้มีอายุไม่นานและจะต้องตั้งค่าพร้อมกับคําขอ PATCH หรือ UPDATE แต่ละรายการ มิฉะนั้นการแจ้งเตือนจะไม่ทริกเกอร์
valueAddedModuleData[]

object (ValueAddedModuleData)

ข้อมูลข้อบังคับมูลค่าเพิ่ม (ไม่บังคับ) นักเรียนสูงสุด 10 คนต่อชั้นเรียน สำหรับบัตร ระบบจะแสดงเพียง 10 รายการ โดยให้ความสำคัญกับบัตรจากวัตถุ

TransitType

Enum
TRANSIT_TYPE_UNSPECIFIED
BUS
bus

ชื่อแทนเดิมของ BUS เลิกใช้งานแล้ว
RAIL
rail

ชื่อแทนเดิมของ RAIL เลิกใช้งานแล้ว
TRAM
tram

ชื่อแทนเดิมของ TRAM เลิกใช้งานแล้ว
FERRY
ferry

ชื่อแทนเดิมของ FERRY เลิกใช้งานแล้ว
OTHER
other

ชื่อแทนเดิมของ OTHER เลิกใช้งานแล้ว

ActivationOptions

ActivationOptions สำหรับชั้นเรียน

การแสดง JSON 
{
  "activationUrl": string,
  "allowReactivation": boolean
}
ช่อง
activationUrl

string

HTTPS URL ที่รองรับเซмантиกของ REST จะใช้เพื่อขอการเปิดใช้งานจากพาร์ทเนอร์สําหรับคุณค่าที่ระบุซึ่งผู้ใช้เรียกให้แสดง
allowReactivation

boolean

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

เมธอด

addmessage

 เพิ่มข้อความไปยังคลาสขนส่งสาธารณะที่อ้างอิงโดยรหัสคลาสที่ระบุ

get

 แสดงผลชั้นยานพาหนะที่มีรหัสชั้นที่ระบุ

insert

 แทรกคลาสขนส่งสาธารณะที่มีรหัสและพร็อพเพอร์ตี้ที่ระบุ

list

 แสดงรายการชั้นขนส่งสาธารณะทั้งหมดสำหรับรหัสผู้ออกบัตรที่ระบุ

patch

 อัปเดตประเภทขนส่งสาธารณะที่อ้างอิงโดยรหัสชั้นเรียนที่ระบุ

update

 อัปเดตประเภทขนส่งสาธารณะที่อ้างอิงโดยรหัสชั้นเรียนที่ระบุ