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)
  }
}
ช่อง
kind
(deprecated)

string

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

classReference

object (EventTicketClass)

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

seatInfo

object (EventSeat)

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

reservationInfo

object (EventReservationInfo)

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

ticketHolderName

string

ชื่อผู้ถือตั๋ว หากมีการกำหนดตั๋วให้กับบุคคล เช่น "สมชาย สกุลดี" หรือ "สมชาย สกุลดี"

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 เป็น 3 เลขฐานสิบหก RGB เช่น #ffcc00 นอกจากนี้ คุณยังสามารถใช้ 3 ไฟล์ 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[]

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 ช่องจากคลาส

rotatingBarcode

object (RotatingBarcode)

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

heroImage

object (Image)

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

passConstraints

object (PassConstraints)

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

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)

ประตูทางออกขึ้นเครื่องที่เจ้าของตั๋วควรเข้าเพื่อไปที่นั่ง เช่น "A" หรือ "West"

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

EventReservationInfo

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

string

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

confirmationCode

string

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

วิธีการ

addmessage

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

get

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

insert

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

list

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

modifylinkedofferobjects

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

patch

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

update

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