REST Resource: eventticketobject

ทรัพยากร: EventTicketObject

การแสดง JSON 
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "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)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
ช่อง
kind
(deprecated)

string

ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "walletobjects#eventTicketObject"
classReference

object (EventTicketClass)

สําเนาของช่องที่รับค่าของคลาสหลัก ระบบจะดึงข้อมูลฟิลด์เหล่านี้ระหว่างการเรียก GET
seatInfo

object (EventSeat)

รายละเอียดที่นั่งสำหรับตั๋วนี้
reservationInfo

object (EventReservationInfo)

รายละเอียดการจองสำหรับตั๋วนี้ โดยคาดว่าจะแชร์กับตั๋วทั้งหมดที่ซื้อในคำสั่งซื้อเดียวกัน
ticketHolderName

string

ชื่อผู้ถือตั๋ว หากตั๋วกำหนดไว้สำหรับบุคคล เช่น "John Doe" หรือ "Jane Doe"
ticketNumber

string

หมายเลขคำขอ ซึ่งอาจเป็นตัวระบุที่ไม่ซ้ำกันสำหรับตั๋วทั้งหมดในระบบของผู้ออกตั๋วทั้งหมด ตั๋วสำหรับกิจกรรม (เช่น XYZ1234512345) หรือตั๋วทั้งหมดในคำสั่งซื้อ (1, 2, 3 ฯลฯ)
ticketType

object (LocalizedString)

ประเภทของตั๋ว เช่น "ผู้ใหญ่" หรือ "เด็ก" หรือ "VIP" หรือ "มาตรฐาน"
faceValue

object (Money)

มูลค่าที่แสดงบนตั๋ว ซึ่งตรงกับสิ่งที่จะพิมพ์บนตั๋วเวอร์ชันสิ่งพิมพ์
groupingInfo

object (GroupingInfo)

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

string

รายการออบเจ็กต์ข้อเสนอที่ลิงก์กับตั๋วกิจกรรมนี้ ออบเจ็กต์ข้อเสนอต้องมีอยู่แล้ว

รหัสออบเจ็กต์ข้อเสนอควรอยู่ในรูปแบบ issuer IDidentifier โดยที่รหัสแรกจะออกโดย Google และรหัสหลังจะเลือกโดยคุณ
hexBackgroundColor

string

สีพื้นหลังของการ์ด หากไม่ได้ตั้งค่า ระบบจะใช้สีหลักของรูปภาพหลัก และหากไม่ได้ตั้งค่ารูปภาพหลัก ระบบจะใช้สีหลักของโลโก้ รูปแบบคือ #rrggbb โดยที่ rrggbb คือไตรต์ RGB แบบเลขฐาน 16 เช่น #ffcc00 นอกจากนี้ คุณยังใช้รูปแบบย่อของไตรต์ RGB ซึ่งก็คือ #rgb เช่น #fc0 ได้ด้วย
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[]
(deprecated)

object (LatLongPoint)

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

boolean

ระบุว่าออบเจ็กต์มีผู้ใช้หรือไม่ แพลตฟอร์มเป็นผู้ตั้งค่าช่องนี้
smartTapRedemptionValue

string

ค่าที่จะส่งไปยังเครื่องชำระเงินที่ผ่านการรับรองของ Smart Tap ผ่าน NFC สำหรับออบเจ็กต์นี้ นอกจากนี้ คุณต้องตั้งค่าช่องระดับชั้นเรียน enableSmartTap และ redemptionIssuers ให้ถูกต้องด้วยเพื่อให้บัตรรองรับการแตะอัจฉริยะ รองรับเฉพาะอักขระ ASCII
hasLinkedDevice

boolean

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

boolean

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

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

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

object (RotatingBarcode)

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

object (Image)

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

object (PassConstraints)

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

object (SaveRestrictions)

ข้อจำกัดของออบเจ็กต์ที่ต้องได้รับการยืนยันก่อนที่ผู้ใช้จะพยายามบันทึกบัตร โปรดทราบว่าข้อจํากัดนี้จะมีผลเฉพาะในช่วงประหยัดเวลาเท่านั้น หากข้อจำกัดมีการเปลี่ยนแปลงหลังจากที่ผู้ใช้บันทึกบัตรแล้ว ข้อจำกัดใหม่จะไม่มีผลกับบัตรที่บันทึกไว้แล้ว
linkedObjectIds[]

string

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

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

รหัสออบเจ็กต์ควรเป็นไปตามรูปแบบ issuer IDidentifier โดยที่รหัสแรกจะออกโดย Google และรหัสหลังจะเลือกโดยคุณ
notifyPreference

enum (NotificationSettingsForUpdates)

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

object (ValueAddedModuleData)

ข้อมูลข้อบังคับมูลค่าเพิ่ม (ไม่บังคับ) สูงสุด 10 รายการบนวัตถุ

EventSeat

การแสดง JSON 
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
ช่อง
kind
(deprecated)

string

ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "walletobjects#eventSeat"
seat

object (LocalizedString)

หมายเลขที่นั่ง เช่น "1", "2", "3" หรือตัวระบุที่นั่งอื่นๆ

ฟิลด์นี้แปลได้ คุณจึงแปลคำหรือใช้ตัวอักษรแบบอื่นสำหรับอักขระในตัวระบุได้
row

object (LocalizedString)

แถวของที่นั่ง เช่น "1", E", "BB" หรือ "A5"

ฟิลด์นี้แปลได้ คุณจึงแปลคำหรือใช้ตัวอักษรอื่นสำหรับอักขระในตัวระบุได้
section

object (LocalizedString)

ส่วนที่นั่ง เช่น "121"

ช่องนี้สามารถแปลได้เพื่อให้คุณสามารถแปลคำหรือใช้ตัวอักษรที่แตกต่างกันสำหรับอักขระในตัวระบุ
gate

object (LocalizedString)

ประตูที่ผู้ถือตั๋วควรเข้าเพื่อไปยังที่นั่ง เช่น "ก" หรือ "ฝั่งตะวันตก"

ช่องนี้สามารถแปลได้เพื่อให้คุณสามารถแปลคำหรือใช้ตัวอักษรที่แตกต่างกันสำหรับอักขระในตัวระบุ

EventReservationInfo

การแสดง JSON 
{
  "kind": string,
  "confirmationCode": string
}
ช่อง
kind
(deprecated)

string

ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "walletobjects#eventReservationInfo"
confirmationCode

string

รหัสยืนยันของการจองกิจกรรม หมายเลขนี้อาจอยู่ในรูปแบบของ "หมายเลขคำสั่งซื้อ" "หมายเลขยืนยัน" "หมายเลขการจอง" หรือรายการอื่นๆ ที่เทียบเท่า

เมธอด

addmessage

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

get

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

insert

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

list

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

modifylinkedofferobjects

 แก้ไขออบเจ็กต์ข้อเสนอที่ลิงก์สำหรับออบเจ็กต์ตั๋วเข้าชมกิจกรรมที่มีรหัสที่ระบุ

patch

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

update

 อัปเดตออบเจ็กต์ตั๋วเข้างานที่อ้างอิงโดยรหัสออบเจ็กต์ที่กำหนด