แหล่งข้อมูล: OfferClass
การแสดง JSON |
---|
{ "kind": string, "title": string, "redemptionChannel": enum ( |
ช่อง | |
---|---|
kind |
ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ |
title |
ต้องระบุ ชื่อของข้อเสนอ เช่น "ลด 20% สำหรับเสื้อยืดทุกตัว" ความยาวสูงสุดที่แนะนำคือ 60 อักขระเพื่อให้สตริงแสดงเต็มในหน้าจอขนาดเล็ก |
redemptionChannel |
ต้องระบุ ช่องทางแลกสิทธิ์ที่ใช้ได้กับข้อเสนอนี้ |
provider |
ต้องระบุ ผู้ให้บริการข้อเสนอ (ชื่อผู้รวบรวมข้อมูลหรือชื่อผู้ขาย) ความยาวสูงสุดที่แนะนำคือ 12 อักขระเพื่อให้สตริงแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก |
titleImage |
รูปภาพชื่อของข้อเสนอ รูปภาพนี้จะแสดงทั้งในมุมมองรายละเอียดและมุมมองรายการของแอป |
details |
รายละเอียดของข้อเสนอ |
finePrint |
รายละเอียดปลีกย่อยหรือข้อกำหนดของข้อเสนอ เช่น "เสื้อยืดทุกตัวที่ Adam's Apparel ลด 20%" |
helpUri |
ลิงก์ความช่วยเหลือสำหรับข้อเสนอ เช่น |
localizedTitle |
สตริงที่แปลแล้วสำหรับชื่อ ความยาวสูงสุดที่แนะนำคือ 60 อักขระเพื่อให้แน่ใจว่าสตริงจะแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก |
localizedProvider |
สตริงที่แปลแล้วสำหรับผู้ให้บริการ ความยาวสูงสุดที่แนะนำคือ 12 อักขระเพื่อให้สตริงแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก |
localizedDetails |
สตริงที่แปลแล้วสำหรับรายละเอียด |
localizedFinePrint |
สตริงที่แปลแล้วสำหรับข้อกำหนดและเงื่อนไข |
shortTitle |
ชื่อข้อเสนอเวอร์ชันย่อ เช่น "ลด 20%" ที่แสดงต่อผู้ใช้เพื่อเป็นข้อมูลอ้างอิงสั้นๆ เกี่ยวกับเนื้อหาข้อเสนอ ความยาวสูงสุดที่แนะนำคือ 20 อักขระ |
localizedShortTitle |
สตริงที่แปลแล้วสำหรับชื่อย่อ ความยาวสูงสุดที่แนะนำคือ 20 อักขระ |
classTemplateInfo |
ข้อมูลเทมเพลตเกี่ยวกับวิธีแสดงชั้นเรียน หากไม่ได้ตั้งค่าไว้ Google จะแสดงชุดช่องเริ่มต้น |
id |
ต้องระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับชั้นเรียน รหัสนี้ต้องไม่ซ้ำกันในทุกชั้นเรียนจากผู้ออกบัตร ค่านี้ควรเป็นไปตามรูปแบบ issuer IDidentifier โดยที่รหัสแรกจะออกโดย Google และรหัสหลังจะเลือกโดยคุณ ตัวระบุที่ไม่ซ้ำกันควรประกอบด้วยอักขระที่เป็นตัวอักษรและตัวเลขคละกัน, '.', '_' หรือ "-" เท่านั้น |
version |
เลิกใช้ |
issuerName |
ต้องระบุ ชื่อผู้ออกบัตร ความยาวสูงสุดที่แนะนำคือ 20 อักขระเพื่อให้สตริงแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก |
messages[] |
อาร์เรย์ข้อความที่แสดงในแอป ผู้ใช้ทั้งหมดของออบเจ็กต์นี้จะได้รับข้อความที่เกี่ยวข้อง จํานวนสูงสุดของช่องเหล่านี้คือ 10 ช่อง |
allowMultipleUsersPerObject |
เลิกใช้งานแล้ว ให้ใช้ |
homepageUri |
URI ของหน้าแรกของแอปพลิเคชัน การป้อนข้อมูล URI ในช่องนี้จะทําให้มีลักษณะการทำงานเหมือนกับการป้อนข้อมูล URI ใน linksModuleData (เมื่อแสดงผลออบเจ็กต์ ลิงก์ไปยังหน้าแรกจะแสดงในส่วนที่มักเรียกว่าส่วน linksModuleData ของออบเจ็กต์) |
locations[] |
หมายเหตุ: ปัจจุบันระบบยังไม่รองรับการใช้ฟิลด์นี้เพื่อทริกเกอร์การแจ้งเตือนตามภูมิศาสตร์ |
reviewStatus |
ต้องระบุ สถานะของชั้นเรียน ช่องนี้สามารถตั้งค่าเป็น คุณควรตั้งค่าฟิลด์นี้เป็น คุณควรตั้งค่าช่องนี้เป็น เมื่ออัปเดตคลาส |
review |
ความคิดเห็นรีวิวที่แพลตฟอร์มตั้งค่าไว้เมื่อมีการทําเครื่องหมายชั้นเรียนเป็น |
infoModuleData |
เลิกใช้งานแล้ว ให้ใช้ textModulesData แทน |
imageModulesData[] |
ข้อมูลโมดูลรูปภาพ จำนวนสูงสุดของช่องเหล่านี้ที่แสดงคือ 1 จากระดับออบเจ็กต์และ 1 สำหรับระดับออบเจ็กต์คลาส |
textModulesData[] |
ข้อมูลโมดูลข้อความ หากมีการกําหนดข้อมูลโมดูลข้อความในคลาสด้วย ระบบจะแสดงทั้ง 2 รายการ จำนวนสูงสุดของช่องเหล่านี้ที่แสดงคือ 10 ช่องจากออบเจ็กต์และ 10 ช่องจากคลาส |
linksModuleData |
ข้อมูลโมดูลลิงก์ หากมีการกําหนดข้อมูลโมดูลลิงก์ในออบเจ็กต์ด้วย ระบบจะแสดงทั้ง 2 รายการ |
redemptionIssuers[] |
ระบุผู้ออกบัตรแลกสิทธิ์ที่แลกแต้มผ่าน Smart Tap ได้ ระบบจะระบุผู้ออกบัตรแลกสิทธิ์ด้วยรหัสผู้ออกบัตร ผู้ออกบัตรแลกสิทธิ์ต้องกำหนดค่าคีย์ Smart Tap อย่างน้อย 1 รายการ นอกจากนี้ คุณต้องตั้งค่าช่อง |
countryCode |
รหัสประเทศที่ใช้แสดงประเทศของการ์ด (เมื่อผู้ใช้ไม่ได้อยู่ในประเทศนั้น) รวมถึงแสดงเนื้อหาที่แปลแล้วเมื่อเนื้อหาไม่พร้อมใช้งานในภาษาของผู้ใช้ |
heroImage |
รูปภาพแบนเนอร์ (ไม่บังคับ) ที่แสดงที่ด้านหน้าของการ์ด หากไม่มี จะไม่มีการแสดงข้อมูลใดๆ รูปภาพจะแสดงที่ความกว้าง 100% |
wordMark |
เลิกใช้งานแล้ว |
enableSmartTap |
ระบุว่าคลาสนี้รองรับการแตะอัจฉริยะหรือไม่ นอกจากนี้ คุณต้องตั้งค่าช่อง |
hexBackgroundColor |
สีพื้นหลังของการ์ด หากไม่ได้ตั้งค่า ระบบจะใช้สีหลักของรูปภาพหลัก และหากไม่ได้ตั้งค่ารูปภาพหลัก ระบบจะใช้สีหลักของโลโก้ รูปแบบคือ #rrggbb โดยที่ rrggbb คือไตรต์ RGB แบบฐาน 16 เช่น |
localizedIssuerName |
สตริงที่แปลแล้วสำหรับ issuerName ความยาวสูงสุดที่แนะนำคือ 20 อักขระเพื่อให้สตริงแสดงเต็มรูปแบบบนหน้าจอขนาดเล็ก |
multipleDevicesAndHoldersAllowedStatus |
ระบุว่าผู้ใช้และอุปกรณ์หลายรายจะบันทึกออบเจ็กต์เดียวกันซึ่งอ้างอิงคลาสนี้หรือไม่ |
callbackOptions |
ตัวเลือกการเรียกกลับที่จะใช้เพื่อโทรกลับหาผู้ออกใบอนุญาตสำหรับการบันทึก/ลบออบเจ็กต์สำหรับคลาสนี้ทุกครั้งโดยผู้ใช้ปลายทาง ออบเจ็กต์ทั้งหมดของคลาสนี้มีสิทธิ์ใช้การเรียกกลับ |
securityAnimation |
ข้อมูลเกี่ยวกับภาพเคลื่อนไหวเกี่ยวกับความปลอดภัย (ไม่บังคับ) หากตั้งค่านี้ ระบบจะแสดงภาพเคลื่อนไหวความปลอดภัยในรายละเอียดบัตร |
viewUnlockRequirement |
ดูตัวเลือกข้อกำหนดในการปลดล็อกสำหรับข้อเสนอ |
wideTitleImage |
รูปภาพชื่อแบบกว้างของข้อเสนอ หากระบุไว้ ระบบจะใช้รูปภาพนี้แทนรูปภาพชื่อที่ด้านซ้ายบนของมุมมองการ์ด |
notifyPreference |
การตั้งค่าว่าควรมีการแจ้งเตือนเมื่อมีการอัปเดตช่องในชั้นเรียนนี้หรือไม่ เมื่อตั้งค่าเป็น "แจ้งเตือน" เราจะพยายามเรียกให้ระบบแจ้งเตือนการอัปเดตช่องแก่ผู้ใช้ ระบบจะส่งการแจ้งเตือนเหล่านี้ไปยังผู้ใช้ก็ต่อเมื่อช่องเป็นส่วนหนึ่งของรายการที่อนุญาตเท่านั้น หากไม่ได้ระบุ ระบบจะไม่ทริกเกอร์การแจ้งเตือน การตั้งค่านี้มีอายุไม่นานและจะต้องตั้งค่าพร้อมกับคําขอ PATCH หรือ UPDATE แต่ละรายการ มิฉะนั้นการแจ้งเตือนจะไม่ทริกเกอร์ |
appLinkData |
ลิงก์แอปหรือเว็บไซต์ (ไม่บังคับ) ที่แสดงเป็นปุ่มที่ด้านหน้าบัตร หากมี AppLinkData สำหรับออบเจ็กต์ที่เกี่ยวข้อง ระบบจะใช้ AppLinkData นั้นแทน |
valueAddedModuleData[] |
ข้อมูลข้อบังคับมูลค่าเพิ่ม (ไม่บังคับ) นักเรียนสูงสุด 10 คนต่อชั้นเรียน สำหรับบัตร ระบบจะแสดงเพียง 10 รายการ โดยให้ความสำคัญกับบัตรจากวัตถุ |
RedemptionChannel
Enum | |
---|---|
REDEMPTION_CHANNEL_UNSPECIFIED |
|
INSTORE |
|
instore |
ชื่อแทนเดิมของ |
ONLINE |
|
online |
ชื่อแทนเดิมของ |
BOTH |
|
both |
ชื่อแทนเดิมของ |
TEMPORARY_PRICE_REDUCTION |
|
temporaryPriceReduction |
ชื่อแทนเดิมของ |
เมธอด |
|
---|---|
|
เพิ่มข้อความลงในคลาสข้อเสนอที่อ้างอิงโดยรหัสคลาสที่ระบุ |
|
แสดงผลคลาสข้อเสนอที่มีรหัสคลาสที่ระบุ |
|
แทรกคลาสข้อเสนอที่มีรหัสและพร็อพเพอร์ตี้ที่ระบุ |
|
แสดงรายการคลาสข้อเสนอทั้งหมดสำหรับรหัสผู้ออกบัตรที่ระบุ |
|
อัปเดตประเภทข้อเสนอที่อ้างอิงโดยรหัสชั้นเรียนที่ระบุ |
|
อัปเดตประเภทข้อเสนอที่อ้างอิงโดยรหัสชั้นเรียนที่ระบุ |