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)
  },
  "appLinkData": {
    object (AppLinkData)
  }
}
ช่อง
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 (เมื่อแสดงผลออบเจ็กต์ ลิงก์ไปยังหน้าแรกจะแสดงในสิ่งที่มักมองว่าเป็นส่วนลิงก์ModuleData ของออบเจ็กต์)

locations[]

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)

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

redemptionIssuers[]

string (int64 format)

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

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

countryCode

string

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

heroImage

object (Image)

รูปภาพแบนเนอร์ที่ไม่บังคับซึ่งแสดงอยู่ด้านหน้าของการ์ด หากไม่มี ก็จะไม่แสดงผลใดๆ รูปภาพจะแสดงที่ความกว้าง 100%

wordMark
(deprecated)

object (Image)

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

enableSmartTap

boolean

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

hexBackgroundColor

string

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

localizedIssuerName

object (LocalizedString)

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

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

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

callbackOptions

object (CallbackOptions)

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

securityAnimation

object (SecurityAnimation)

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

activationOptions

object (ActivationOptions)

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

viewUnlockRequirement

enum (ViewUnlockRequirement)

ดูตัวเลือกข้อกำหนดในการปลดล็อกสำหรับตั๋วโดยสาร

TransitType

Enum
TRANSIT_TYPE_UNSPECIFIED
BUS
bus

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

RAIL
rail

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

TRAM
tram

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

FERRY
ferry

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

OTHER
other

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

ActivationOptions

ตัวเลือกการเปิดใช้งานสำหรับชั้นเรียน

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

string

HTTPS URL ที่รองรับความหมายของ REST จะใช้เพื่อขอเปิดใช้งานจากพาร์ทเนอร์สำหรับเนื้อหาที่มีคุณค่าซึ่งทริกเกอร์โดยผู้ใช้

allowReactivation

boolean

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

เมธอด

addmessage

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

get

แสดงผลประเภทขนส่งสาธารณะที่มีรหัสคลาสที่ระบุ

insert

แทรกชั้นโดยสารที่มีรหัสและพร็อพเพอร์ตี้ที่ระบุ

list

แสดงผลรายการคลาสการขนส่งทั้งหมดสำหรับรหัสผู้ออกคีย์ที่ระบุ

patch

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

update

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