แหล่งข้อมูล: GiftCardObject
การแสดง JSON |
---|
{ "kind": string, "classReference": { object ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ |
classReference |
สำเนาของช่องที่รับค่ามาจากคลาสระดับบนสุด ระบบจะดึงข้อมูลช่องเหล่านี้ขึ้นมาระหว่าง GET |
cardNumber |
ต้องระบุ หมายเลขบัตร |
pin |
PIN ของบัตร |
balance |
ยอดเงินคงเหลือของบัตร |
balanceUpdateTime |
วันที่และเวลาที่อัปเดตยอดคงเหลือครั้งล่าสุด ต้องมีออฟเซ็ต หากมีการอัปเดตยอดคงเหลือและไม่ได้ระบุพร็อพเพอร์ตี้นี้ ระบบจะใช้ค่าเริ่มต้นเป็นเวลาปัจจุบัน |
eventNumber |
หมายเลขกิจกรรมของบัตร ซึ่งเป็นช่องที่ไม่บังคับสำหรับบัตรของขวัญบางรายการ |
id |
ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับออบเจ็กต์ รหัสนี้ต้องไม่ซ้ำกันในทุกออบเจ็กต์จากผู้ออกบัตร ค่านี้ควรเป็นไปตามรูปแบบ issuer IDidentifier โดยที่ Google เป็นผู้ออกนโยบายเก่าและคุณเป็นผู้เลือกรายการหลัง ตัวระบุที่ไม่ซ้ำกันควรมีเฉพาะอักขระที่เป็นตัวอักษรและตัวเลขคละกัน, ".", "_" หรือ "-" เท่านั้น |
classId |
ต้องระบุ คลาสที่เชื่อมโยงกับออบเจ็กต์นี้ คลาสต้องเป็นประเภทเดียวกับออบเจ็กต์นี้ ต้องมีอยู่แล้วและต้องได้รับอนุมัติ รหัสชั้นเรียนควรเป็นไปตามรูปแบบ issuer IDidentifier โดยที่ Google เป็นผู้ออกนโยบายเก่าและคุณเป็นผู้เลือกรายการหลัง |
version |
เลิกใช้ |
state |
ต้องระบุ สถานะของออบเจ็กต์ ช่องนี้ใช้ในการกำหนดลักษณะการแสดงออบเจ็กต์ในแอป เช่น ระบบจะย้ายออบเจ็กต์ |
barcode |
ประเภทและค่าบาร์โค้ด |
messages[] |
อาร์เรย์ของข้อความที่แสดงในแอป ผู้ใช้ทั้งหมดของออบเจ็กต์นี้จะได้รับข้อความที่เกี่ยวข้อง จำนวนช่องสูงสุดคือ 10 ช่อง |
validTimeInterval |
ระยะเวลาที่ออบเจ็กต์นี้จะอยู่ในช่วง |
locations[] |
หมายเหตุ: ปัจจุบันช่องนี้ยังไม่รองรับการเรียกการแจ้งเตือนทางภูมิศาสตร์ |
hasUsers |
ระบุว่าออบเจ็กต์มีผู้ใช้หรือไม่ ช่องนี้จะตั้งค่าโดยแพลตฟอร์ม |
smartTapRedemptionValue |
ค่าที่จะส่งไปยังเครื่องชำระเงินที่ได้รับการรับรองของการแตะอัจฉริยะผ่าน NFC สำหรับออบเจ็กต์นี้ นอกจากนี้ ต้องตั้งค่าช่องระดับ |
hasLinkedDevice |
ออบเจ็กต์นี้ลิงก์กับอุปกรณ์เครื่องเดียวอยู่หรือไม่ ช่องนี้จะกำหนดโดยแพลตฟอร์มเมื่อผู้ใช้บันทึกวัตถุและลิงก์วัตถุนั้นกับอุปกรณ์ของตน มีไว้สำหรับใช้โดยพาร์ทเนอร์บางราย โปรดติดต่อทีมสนับสนุนเพื่อขอข้อมูลเพิ่มเติม |
disableExpirationNotification |
ระบุว่าควรระงับการแจ้งเตือนอย่างชัดแจ้งหรือไม่ หากตั้งค่าช่องนี้เป็น "จริง" ไม่ว่าช่อง ปัจจุบันตั้งค่านี้ได้สำหรับข้อเสนอเท่านั้น |
infoModuleData |
เลิกใช้งานแล้ว โปรดใช้ textModulesData แทน |
imageModulesData[] |
ข้อมูลโมดูลรูปภาพ จำนวนสูงสุดของช่องที่แสดงเหล่านี้คือ 1 ช่องจากระดับออบเจ็กต์ และ 1 ช่องสำหรับระดับออบเจ็กต์คลาส |
textModulesData[] |
ข้อมูลโมดูลข้อความ หากมีการกำหนดข้อมูลโมดูลข้อความไว้ในคลาสด้วย ระบบจะแสดงทั้ง 2 รายการ โดยจำนวนสูงสุดของช่องที่แสดงคือ 10 ช่องจากออบเจ็กต์ และ 10 ช่องจากคลาส |
linksModuleData |
ข้อมูลโมดูลลิงก์ หากมีการกำหนดข้อมูลโมดูลลิงก์ไว้ในคลาสด้วย ระบบจะแสดงทั้ง 2 รายการ |
appLinkData |
ลิงก์ของแอปหรือเว็บไซต์ (ไม่บังคับ) ซึ่งจะแสดงเป็นปุ่มที่ด้านหน้าบัตร หากมีการระบุ AppLinkData สำหรับออบเจ็กต์เฉพาะคลาสที่เกี่ยวข้อง ระบบจะแสดง AppLinkData |
rotatingBarcode |
ประเภทและค่าบาร์โค้ดแบบหมุน |
heroImage |
รูปภาพแบนเนอร์ที่ไม่บังคับจะแสดงที่ด้านหน้าการ์ด หากไม่มี ระบบจะแสดงรูปภาพหลักของชั้นเรียน (หากมี) หากไม่มีรูปภาพหลักของชั้นเรียนด้วย ก็จะไม่มีรูปภาพใดๆ ปรากฏขึ้น |
groupingInfo |
ข้อมูลที่ควบคุมวิธีจัดกลุ่มบัตรเข้าด้วยกัน |
passConstraints |
ส่งผ่านข้อจำกัดสำหรับออบเจ็กต์ รวมถึงการจำกัดการทำงานของ NFC และภาพหน้าจอ |
วิธีการ |
|
---|---|
|
เพิ่มข้อความลงในออบเจ็กต์บัตรของขวัญที่อ้างอิงด้วยรหัสออบเจ็กต์ที่ระบุ |
|
แสดงผลออบเจ็กต์บัตรของขวัญที่มีรหัสออบเจ็กต์ที่ระบุ |
|
แทรกออบเจ็กต์บัตรของขวัญที่มีรหัสและพร็อพเพอร์ตี้ที่ระบุ |
|
แสดงรายการออบเจ็กต์บัตรของขวัญทั้งหมดสำหรับรหัสผู้ออกบัตรที่ระบุ |
|
อัปเดตออบเจ็กต์บัตรของขวัญที่อ้างอิงด้วยรหัสออบเจ็กต์ที่ระบุ |
|
อัปเดตออบเจ็กต์บัตรของขวัญที่อ้างอิงด้วยรหัสออบเจ็กต์ที่ระบุ |