REST Resource: loyaltyclass

ทรัพยากร: LoyaltyClass

การแสดง JSON 
{
  "kind": string,
  "programName": string,
  "programLogo": {
    object (Image)
  },
  "accountNameLabel": string,
  "accountIdLabel": string,
  "rewardsTierLabel": string,
  "rewardsTier": string,
  "localizedProgramName": {
    object (LocalizedString)
  },
  "localizedAccountNameLabel": {
    object (LocalizedString)
  },
  "localizedAccountIdLabel": {
    object (LocalizedString)
  },
  "localizedRewardsTierLabel": {
    object (LocalizedString)
  },
  "localizedRewardsTier": {
    object (LocalizedString)
  },
  "secondaryRewardsTierLabel": string,
  "localizedSecondaryRewardsTierLabel": {
    object (LocalizedString)
  },
  "secondaryRewardsTier": string,
  "localizedSecondaryRewardsTier": {
    object (LocalizedString)
  },
  "discoverableProgram": {
    object (DiscoverableProgram)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "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)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideProgramLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
ช่อง
kind
(deprecated)

string

ระบุว่านี่คือทรัพยากรประเภทใด ค่า: สตริงคงที่ "walletobjects#loyaltyClass"
programName

string

ต้องระบุ ชื่อโปรแกรม เช่น "Adam's Apparel" แอปอาจแสดงจุดไข่ปลาหลังอักขระ 20 ตัวแรกเพื่อให้มั่นใจว่าระบบจะแสดงสตริงทั้งหมดในหน้าจอขนาดเล็ก
accountNameLabel

string

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

string

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

string

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

string

ระดับรางวัล เช่น "โกลด์" หรือ "แพลตินัม" ความยาวสูงสุดที่แนะนำคือ 7 อักขระเพื่อให้สตริงแสดงเต็มในหน้าจอขนาดเล็ก
localizedProgramName

object (LocalizedString)

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

object (LocalizedString)

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

object (LocalizedString)

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

object (LocalizedString)

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

object (LocalizedString)

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

string

ป้ายกำกับอันดับรางวัลรอง เช่น "ระดับรางวัล"
localizedSecondaryRewardsTierLabel

object (LocalizedString)

สตริงที่แปลแล้วสำหรับโดเมนรองRewardsTierLabel
secondaryRewardsTier

string

อันดับรางวัลรอง เช่น "โกลด์" หรือ "แพลตินัม"
localizedSecondaryRewardsTier

object (LocalizedString)

สตริงที่แปลแล้วสำหรับ RewardsTier รอง
discoverableProgram

object (DiscoverableProgram)

ข้อมูลเกี่ยวกับวิธีค้นพบและสร้างอินสแตนซ์คลาสจากภายในแอป Google Pay
classTemplateInfo

object (ClassTemplateInfo)

ข้อมูลเทมเพลตเกี่ยวกับวิธีแสดงชั้นเรียน หากไม่ได้ตั้งค่าไว้ Google จะแสดงชุดช่องเริ่มต้น
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 (เมื่อแสดงผลออบเจ็กต์ ลิงก์ไปยังหน้าแรกจะแสดงในส่วนที่มักเรียกว่าส่วน linksModuleData ของออบเจ็กต์)
locations[]
(deprecated)

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)

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

string (int64 format)

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

นอกจากนี้ ยังต้องตั้งค่าช่อง enableSmartTap และช่องใดช่องหนึ่งระดับออบเจ็กต์ smartTapRedemptionValue, barcode.value, oraccountId` ให้ถูกต้องเพื่อให้บัตรรองรับการแตะอัจฉริยะ
countryCode

string

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

object (Image)

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

object (Image)

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

boolean

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

string

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

object (LocalizedString)

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

enum (MultipleDevicesAndHoldersAllowedStatus)

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

object (CallbackOptions)

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

object (SecurityAnimation)

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

enum (ViewUnlockRequirement)

ดูตัวเลือกข้อกำหนดในการปลดล็อกสำหรับบัตรสะสมคะแนน
notifyPreference

enum (NotificationSettingsForUpdates)

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

object (ValueAddedModuleData)

ข้อมูลข้อบังคับมูลค่าเพิ่ม (ไม่บังคับ) นักเรียนสูงสุด 10 คนต่อชั้นเรียน สำหรับบัตรผ่าน ระบบจะแสดงเพียง 10 รายการโดยจัดลำดับความสำคัญของบัตรเหล่านั้นจากออบเจ็กต์

DiscoverableProgram

ข้อมูลเกี่ยวกับวิธีค้นพบและสร้างอินสแตนซ์ของคลาสจากภายในแอป Android Pay ซึ่งทำได้โดยการค้นหาโปรแกรมสะสมคะแนนหรือบัตรของขวัญ แล้วสแกนหรือป้อนข้อมูลด้วยตนเอง

การแสดง JSON 
{
  "merchantSignupInfo": {
    object (DiscoverableProgramMerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (DiscoverableProgramMerchantSigninInfo)
  },
  "state": enum (State)
}
ช่อง
merchantSignupInfo

object (DiscoverableProgramMerchantSignupInfo)

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

object (DiscoverableProgramMerchantSigninInfo)

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

enum (State)

สถานะการเปิดเผยของโปรแกรมที่ค้นพบได้

DiscoverableProgramMerchantSignupInfo

ข้อมูลเกี่ยวกับขั้นตอนการลงชื่อสมัครใช้โปรแกรมที่ผู้ขายโฮสต์

การแสดง JSON 
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
ช่อง
signupWebsite

object (Uri)

URL สำหรับนำผู้ใช้ไปยังเว็บไซต์ลงชื่อสมัครใช้ของผู้ขาย
signupSharedDatas[]

enum (SharedDataType)

ข้อมูลผู้ใช้ที่ส่งในคําขอ POST ไปยัง URL ของเว็บไซต์ลงชื่อสมัครใช้ ระบบจะเข้ารหัสข้อมูลนี้และแชร์ข้อมูลเพื่อให้เว็บไซต์ของผู้ขายกรอกข้อมูลล่วงหน้าในช่องที่ใช้ลงทะเบียนผู้ใช้สำหรับโปรแกรมที่ค้นพบได้

SharedDataType

Enum
SHARED_DATA_TYPE_UNSPECIFIED
FIRST_NAME
LAST_NAME
STREET_ADDRESS ช่องที่อยู่บรรทัดเดียว
ADDRESS_LINE_1 ช่องที่อยู่หลายบรรทัด
ADDRESS_LINE_2
ADDRESS_LINE_3
CITY
STATE
ZIPCODE
COUNTRY
EMAIL
PHONE

DiscoverableProgramMerchantSigninInfo

ข้อมูลเกี่ยวกับขั้นตอนการลงชื่อเข้าใช้ที่ผู้ขายโฮสต์สำหรับโปรแกรม

การแสดง JSON 
{
  "signinWebsite": {
    object (Uri)
  }
}
ช่อง
signinWebsite

object (Uri)

URL สำหรับนำผู้ใช้ไปยังเว็บไซต์ลงชื่อเข้าใช้ของผู้ขาย

รัฐ

Enum
STATE_UNSPECIFIED
TRUSTED_TESTERS แสดงต่อผู้ทดสอบที่มีสิทธิ์เข้าถึงบัญชีผู้ออกบัตรเท่านั้น
trustedTesters

ชื่อแทนเดิมของ TRUSTED_TESTERS เลิกใช้งานแล้ว
LIVE แสดงต่อทุกคน
live

ชื่อแทนเดิมของ LIVE เลิกใช้งานแล้ว
DISABLED ไม่แสดง
disabled

ชื่อแทนเดิมของ DISABLED เลิกใช้งานแล้ว

เมธอด

addmessage

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

get

 แสดงผลระดับโปรแกรมสะสมคะแนนที่มีรหัสระดับที่ระบุ

insert

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

list

 แสดงรายการระดับการเป็นสมาชิกทั้งหมดสำหรับรหัสผู้ออกบัตรที่ระบุ

patch

 อัปเดตคลาสโปรแกรมสะสมคะแนนที่อ้างอิงตามรหัสคลาสที่ระบุ

update

 อัปเดตประเภทการสะสมคะแนนที่อ้างอิงโดยรหัสชั้นที่ระบุ