資源:LoyaltyClass
JSON 表示法 |
---|
{ "kind": string, "programName": string, "programLogo": { object ( |
欄位 | |
---|---|
kind |
識別資源的種類。值:固定字串 |
programName |
必要欄位。方案名稱,例如「小明服飾」。應用程式可能會在前 20 個字元之後顯示刪節號,確保在較小的螢幕上可顯示完整字串。 |
programLogo |
必要欄位。會員方案或公司的標誌。這個標誌會顯示在應用程式的詳細資料和清單檢視畫面中。 |
accountNameLabel |
帳戶名稱標籤,例如「成員名稱」。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
accountIdLabel |
帳戶 ID 標籤,例如「成員 ID」。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
rewardsTierLabel |
獎勵級別標籤,例如「獎勵級別」。建議長度上限為 9 個字元,以確保在較小的螢幕上可顯示完整字串。 |
rewardsTier |
獎勵級別,例如「金級」或「白金級」。建議長度上限為 7 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localizedProgramName |
programName 的翻譯字串。應用程式可能會在前 20 個字元之後顯示刪節號,確保在較小的螢幕上可顯示完整字串。 |
localizedAccountNameLabel |
accountNameLabel 的翻譯字串。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localizedAccountIdLabel |
accountIdLabel 的翻譯字串。建議長度上限為 15 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localizedRewardsTierLabel |
RewardsTierLabel 的翻譯字串。建議長度上限為 9 個字元,以確保在較小的螢幕上可顯示完整字串。 |
localizedRewardsTier |
RewardsTier 的翻譯字串。建議長度上限為 7 個字元,以確保在較小的螢幕上可顯示完整字串。 |
secondaryRewardsTierLabel |
次要獎勵級別標籤,例如「獎勵級別」。 |
localizedSecondaryRewardsTierLabel |
secondaryRewardsTierLabel 的翻譯字串。 |
secondaryRewardsTier |
次要獎勵級別,例如「金級」或「白金級」。 |
localizedSecondaryRewardsTier |
secondaryRewardsTier 的翻譯字串。 |
discoverableProgram |
關於如何在 Google Pay 應用程式中探索類別及建立例項的相關資訊。 |
classTemplateInfo |
類別顯示方式的範本資訊。如未設定,Google 會改回顯示一組預設欄位。 |
id |
必要欄位。類別的專屬 ID。特定核發者的所有類別 ID 都不得重複。這個值應採用以下格式:issuer ID。identifier,其中前者是由 Google 核發,後者則您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
version |
已淘汰 |
issuerName |
必要欄位。核發者的名稱。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
messages[] |
應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限為 10 個。 |
allowMultipleUsersPerObject |
已淘汰,請改用 |
homepageUri |
應用程式首頁的 URI。在這個欄位填入 URI 會產生與在 linksModuleData 填入 URI 相同的行為 (轉譯物件時,首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。 |
locations[] |
注意:這個欄位目前不支援觸發地理通知。 |
reviewStatus |
必要欄位。類別的狀態。可以透過 insert、patch 或更新 API 呼叫,將此欄位設為 當類別處於開發階段時,這個欄位應保留為 如果您確認類別可供使用,應將這個欄位設為 更新已處於 |
review |
當類別標示為 |
infoModuleData |
已淘汰,請改用 textModulesData。 |
imageModulesData[] |
圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個,以及類別物件層級 1 個。 |
textModulesData[] |
文字模組資料。如果類別中也定義了文字模組資料,則兩項資料都會顯示。這類欄位的顯示數量上限為物件中的 10 個,以及類別中的 10 個。 |
linksModuleData |
連結模組資料。如果物件中也定義了連結模組資料,則兩項資料都會顯示。 |
redemptionIssuers[] |
找出哪些兌換核發機構可以透過智慧感應功能兌換票證。兌換核發機構由其核發機構 ID 識別。兌換核發機構必須設定至少一個智慧感應功能。 您也必須正確設定 |
countryCode |
國家/地區代碼,用於顯示卡片的國家/地區 (當使用者不在該國家/地區時),以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。 |
heroImage |
顯示在資訊卡正面的選用橫幅圖片。如果沒有顯示任何項目,系統就不會顯示任何內容。圖片寬度為 100%。 |
wordMark |
已淘汰。 |
enableSmartTap |
指出這個類別是否支援智慧感應功能。您也必須正確設定 |
hexBackgroundColor |
資訊卡的背景顏色。如果未設定,將會使用主頁橫幅的主要顏色;如果未設定主頁橫幅,則會使用標誌的主要顏色。格式為 #rrggbb,其中 rrggbb 是十六進位的 RGB 三元組,例如 |
localizedIssuerName |
cardName 的翻譯字串。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
multipleDevicesAndHoldersAllowedStatus |
指出是否有多位使用者和多台裝置會儲存參照這個類別的同一個物件。 |
callbackOptions |
使用者每次儲存/刪除這個類別的物件時,都可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼。 |
securityAnimation |
關於安全性動畫的選擇性資訊。如果設定了這項政策,票證詳細資料就會顯示安全性動畫。 |
viewUnlockRequirement |
查看會員卡的解鎖要求選項。 |
wideProgramLogo |
會員方案或公司的寬版標誌。若提供這項資訊,此項目會用來取代資訊卡檢視左上方的節目標誌。 |
appLinkData |
選用的應用程式或網站連結,會顯示在票證正面的按鈕中。如果你已為相應的物件提供 AppLinkData,系統將改用對應的物件。 |
DiscoverableProgram
如何在 Android Pay 應用程式中探索類別及建立例項的相關資訊。這方法是搜尋會員方案或禮物卡方案,然後掃描或手動輸入。
JSON 表示法 |
---|
{ "merchantSignupInfo": { object ( |
欄位 | |
---|---|
merchantSignupInfo |
透過商家網站註冊並為該方案新增有價值項目之功能的相關資訊。在已啟用 MERCHANT_HOSTED_SIGNUP 時使用。 |
merchantSigninInfo |
透過商家網站登入並為該方案添加有價值項目之功能的相關資訊。在已啟用 MERCHANT_HOSTED_SIGNIN 時使用。 |
state |
可探索方案的顯示狀態。 |
DiscoverableProgramMerchantSignupInfo
某商家代管方案註冊流程的相關資訊。
JSON 表示法 |
---|
{ "signupWebsite": { object ( |
欄位 | |
---|---|
signupWebsite |
將使用者導向商家註冊網站的網址。 |
signupSharedDatas[] |
在 POST 要求中傳送到註冊網站網址的使用者資料。這項資訊經過編碼並分享,以便商家網站預先填入欄位,以便為使用者註冊可供探索的方案。 |
DiscoverableProgramMerchantSigninInfo
某商家方案的代管登入流程相關資訊。
JSON 表示法 |
---|
{
"signinWebsite": {
object ( |
欄位 | |
---|---|
signinWebsite |
將使用者導向商家登入網站的網址。 |
狀態
列舉 | |
---|---|
STATE_UNSPECIFIED |
|
TRUSTED_TESTERS |
只有可存取核發者帳戶的測試人員才能看到。 |
trustedTesters |
|
LIVE |
所有使用者都能看見。 |
live |
|
DISABLED |
隱藏。 |
disabled |
|
方法 |
|
---|---|
|
在指定類別 ID 參照的會員類別中新增訊息。 |
|
傳回具有指定類別 ID 的會員類別。 |
|
插入具有指定 ID 和屬性的會員類別。 |
|
傳回指定核發者 ID 的所有會員類別清單。 |
|
更新指定類別 ID 參照的會員類別。 |
|
更新指定類別 ID 參照的會員類別。 |