REST Resource: loyaltyclass

{
  "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)
    }
  ]
}

string

表示資源的種類。值：固定字串 "walletobjects#loyaltyClass"。

string

必要欄位。方案名稱，例如「小明服飾店」。應用程式可能會在前 20 個字元之後顯示省略符號，以確保在較小的螢幕上可顯示完整字串。

object (Image)

必要欄位。會員方案或公司的標誌。這個標誌會顯示在應用程式的詳細資料和清單檢視畫面中。

string

帳戶名稱標籤，例如「會員姓名」。建議長度上限為 15 個字元，以確保在較小的螢幕上可顯示完整字串。

string

帳戶 ID 標籤，例如「會員 ID」。建議長度上限為 15 個字元，以確保在較小的螢幕上可顯示完整字串。

string

獎勵級別標籤，例如「獎勵級別」。建議長度上限為 9 個字元，以確保在較小的螢幕上可顯示完整字串。

string

獎勵級別，例如「爍金」或「白金」。建議長度上限為 7 個字元，以確保在較小的螢幕上可顯示完整字串。

object (LocalizedString)

programName 的翻譯字串。應用程式可能會在前 20 個字元之後顯示省略符號，以確保在較小的螢幕上可顯示完整字串。

object (LocalizedString)

accountNameLabel 的翻譯字串。建議長度上限為 15 個字元，以確保在較小的螢幕上可顯示完整字串。

object (LocalizedString)

accountIdLabel 的翻譯字串。建議長度上限為 15 個字元，以確保在較小的螢幕上可顯示完整字串。

object (LocalizedString)

rewardsTierLabel 的翻譯字串。建議長度上限為 9 個字元，以確保在較小的螢幕上可顯示完整字串。

object (LocalizedString)

rewardsTier 的翻譯字串。建議長度上限為 7 個字元，以確保在較小的螢幕上可顯示完整字串。

string

次要獎勵級別標籤，例如「獎勵級別」。

object (LocalizedString)

secondaryRewardsTierLabel 的翻譯字串。

string

次要獎勵級別，例如「爍金」或「白金」。

object (LocalizedString)

secondaryRewardsTier 的翻譯字串。

object (DiscoverableProgram)

如何在 Google Pay 應用程式中探索類別及建立例項的相關資訊。

object (ClassTemplateInfo)

類別顯示方式的範本資訊。如未設定，Google 會恢復為顯示一組預設的欄位。

string

必要欄位。類別的專屬 ID。特定核發者的所有類別 ID 都不得重複。這個值應依循 issuer ID 格式。identifier 的格式，其中前者是由 Google 核發，後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。

string (int64 format)

已淘汰

string

必要欄位。核發者名稱。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。

object (Message)

應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限是 10 個。

boolean

已淘汰，請改用 multipleDevicesAndHoldersAllowedStatus。

object (Uri)

應用程式首頁的 URI。在這個欄位填入 URI 所產生的行為與在 linksModuleData 填入 URI 相同 (顯示物件時，首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。

object (LatLongPoint)

注意：這個欄位目前不支援觸發地理通知。

enum (ReviewStatus)

必要欄位。課程的狀態。可以透過插入、修補或更新 API 呼叫，將這個欄位設為 draft 或 underReview。一旦審查狀態從 draft 變更為其他狀態，就無法再變回 draft。

類別仍在開發階段時，這個欄位應維持 draft。draft 類別無法用於建立任何物件。

如果您確認類別可供使用，應將這個欄位設為 underReview。平台會自動將此欄位設為 approved，這樣就能立即用以建立或遷移物件。

更新已處於 approved 的類別時，請繼續將這個欄位設為 underReview。

object (Review)

當類別標示為 approved 或 rejected 時，平台所設定的審查留言。

object (InfoModuleData)

已淘汰，請改用 textModulesData。

object (ImageModuleData)

圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個，類別物件層級則為 1 個。

object (TextModuleData)

文字模組資料。如果類別中也定義了文字模組資料，則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個，以及來自類別的 10 個。

object (LinksModuleData)

連結模組資料。如果物件中也定義了連結模組資料，則兩項資料都會顯示。

string (int64 format)

指出哪些兌換核發機構可透過智慧感應功能兌換票證。票證兌換機構 ID 可用於辨識票證兌換機構。兌換發放者必須設定至少一個智慧輕觸按鍵。

enableSmartTap 和物件層級的 smartTapRedemptionValue、barcode.value, oraccountId` 欄位也必須正確設定，才能讓票證支援智慧觸碰功能。

string

國家/地區代碼，用於顯示卡片的國家/地區 (當使用者不在該國家/地區時)，以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。

object (Image)

顯示在資訊卡正面的選用橫幅圖片。如果未提供，就不會顯示任何圖片。圖片會以 100% 寛度顯示。

object (Image)

已淘汰。

boolean

識別此類別是否支援智慧感應功能。redemptionIssuers 和物件層級的 smartTapRedemptionLevel、barcode.value, or accountId` 欄位也必須正確設定，才能讓票證支援智慧觸碰功能。

string

卡片的背景顏色。如未設定，則會使用主頁橫幅的主要顏色。如未設定主頁橫幅，則會使用標誌的主要顏色。格式為 #rrggbb，其中 rrggbb 是採十六進位制的 RGB 三位元組，例如 #ffcc00。您也可以使用 RGB 三元組的簡寫版本 #rgb，例如 #fc0。

object (LocalizedString)

providerName 的翻譯字串。建議長度上限為 20 個字元，以確保在較小的螢幕上可顯示完整字串。

enum (MultipleDevicesAndHoldersAllowedStatus)

表示是否有多位使用者和多台裝置會儲存參照這個類別的相同物件。

object (CallbackOptions)

每當使用者儲存/刪除這個類別的物件時，可以使用這些回呼選項來呼叫發卡機構。這個類別的所有物件都適用回呼功能。

object (SecurityAnimation)

安全防護動畫的相關資訊 (選填)。如果設定此屬性，票證詳細資料上會顯示安全性動畫。

enum (ViewUnlockRequirement)

查看會員卡的「解鎖條件」選項。

object (Image)

會員方案或公司的寬版標誌。提供此標誌後，系統會在卡片檢視畫面左上角使用此標誌，取代原有的計畫標誌。

enum (NotificationSettingsForUpdates)

是否要針對這個類別更新欄位更新觸發通知。如果設為 NOTIFY，我們會嘗試觸發向使用者發出欄位更新通知。只有在欄位屬於許可清單的一部分時，系統才會傳送這些通知給使用者。如未指定，系統就不會觸發任何通知。這是暫時性的設定，且必須為每個 PATCH 或 UPDATE 要求進行設置，否則不會觸發通知。

object (AppLinkData)

應用程式或網站連結 (選用) 會顯示為票證正面按鈕。如果為對應的物件提供 AppLinkData，系統會改用該值。

object (ValueAddedModuleData)

選用價值加值模組資料。每堂課最多可容納十位學生。票證中只會顯示十個票證，請從物件中優先顯示這些票證。