資源:GiftCardClass
JSON 表示法 |
---|
{ "kind": string, "merchantName": string, "programLogo": { object ( |
欄位 | |
---|---|
kind |
表示資源的種類。值:固定字串 |
merchant |
商家名稱,例如「小明服飾店」。應用程式可能會在前 20 個字元之後顯示省略符號,以確保在較小的螢幕上可顯示完整字串。 |
program |
禮物卡方案或公司的標誌。這個標誌會顯示在應用程式的詳細資料和清單檢視畫面中。 |
pin |
用來表示 PIN 碼的標籤,例如「4 位數 PIN 碼」。 |
event |
用來表示活動編號的標籤,例如「目標活動編號」。 |
allow |
決定商家是否支援使用條碼兌換禮物卡。如果值為 true,應用程式會在儲值卡詳細資料畫面上顯示儲值卡的條碼。如果值為 false,則不會顯示條碼。 |
localized |
businessName 的翻譯字串。應用程式可能會在前 20 個字元之後顯示省略符號,以確保在較小的螢幕上可顯示完整字串。 |
localized |
pinLabel 的翻譯字串。 |
localized |
eventNumberLabel 的翻譯字串。 |
card |
用來表示卡片號碼的標籤,例如「卡號」。 |
localized |
cardNumberLabel 的翻譯字串。 |
class |
類別顯示方式的範本資訊。如未設定,Google 會恢復為顯示一組預設的欄位。 |
id |
必要欄位。類別的專屬 ID。這個 ID 不得與同一核發機構的其他類別 ID 相同。這個值應依循 issuer ID 格式。identifier 的格式,其中前者是由 Google 核發,後者則由您指定。專屬 ID 只能包含英數字元、「.」、「_」或「-」。 |
version |
已淘汰 |
issuer |
必要欄位。發卡機構名稱。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
messages[] |
應用程式中顯示的訊息陣列。這個物件的所有使用者都會收到與該物件相關聯的訊息。這類欄位的數量上限是 10 個。 |
allowMultipleUsersPerObject |
已淘汰,請改用 |
homepage |
應用程式首頁的 URI。在這個欄位填入 URI 所產生的行為與在 linksModuleData 填入 URI 相同 (轉譯物件時,首頁的連結會顯示在通常視為物件 linksModuleData 區段的地方)。 |
locations[] |
注意:系統目前不支援使用這個欄位觸發地理通知。 |
review |
必要欄位。類別的狀態。可以透過插入、修補或更新 API 呼叫的方式,將這個欄位設為 類別仍在開發階段時,這個欄位應維持 如果您確認類別可供使用,應將此欄位設為 更新已處於 |
review |
類別標示為 |
infoModuleData |
已淘汰,請改用 textModulesData。 |
image |
圖片模組資料。這類欄位的顯示數量上限為物件層級 1 個,以及類別物件層級 1 個。 |
text |
文字模組資料。如果類別中也定義了文字模組資料,則兩項資料都會顯示。這類欄位的顯示數量上限為來自物件的 10 個,以及來自類別的 10 個。 |
links |
連結模組資料。如果物件中也定義了連結模組資料,則兩項資料都會顯示。 |
redemption |
指出哪些兌換核發機構可透過智慧感應功能兌換票證。票證兌換機構 ID 可用於辨識票證兌換機構。兌換核發機構至少須設定一組智慧感應功能金鑰。
|
country |
國家/地區代碼,用於顯示卡片的國家/地區 (當使用者不在該國家/地區時),以及用於顯示本地化內容 (當沒有使用者語言代碼適用的內容時)。 |
hero |
顯示在卡片正面的選用橫幅圖片。如果未提供,就不會顯示任何圖片。圖片會以 100% 寛度顯示。 |
wordMark |
已淘汰。 |
enable |
識別這個類別是否支援智慧感應功能。 |
hex |
卡片的背景顏色。如果未設定,系統會使用主頁橫幅的主要顏色;如果未設定主頁橫幅,系統會使用標誌的主要顏色。格式為 #rrggbb,其中 rrggbb 是採十六進位制的 RGB 三位元組,例如 |
localized |
issuerName 的翻譯字串。建議長度上限為 20 個字元,以確保在較小的螢幕上可顯示完整字串。 |
multiple |
表示是否有多位使用者和多台裝置會儲存參照這個類別的相同物件。 |
callback |
使用者每次儲存/刪除這個類別的物件時,都可以使用這些回呼選項來回呼發卡機構。這個類別的所有物件都適用回呼功能。 |
security |
安全防護動畫的相關資訊 (選填)。如果設為此值,系統會在通行證詳細資料上顯示安全性動畫。 |
view |
查看禮物卡的「解鎖條件」選項。 |
wide |
禮物卡方案或公司的寬版標誌。提供此標誌後,系統會在卡片檢視畫面左上角使用此標誌,取代原有的計畫標誌。 |
notify |
這個類別的欄位更新是否應觸發通知。如果設為 NOTIFY,我們會嘗試觸發向使用者發出欄位更新通知。只有在欄位屬於許可清單的一部分時,系統才會傳送這些通知給使用者。如未指定,系統就不會觸發任何通知。這項設定是暫時性的,需要在每次 PATCH 或 UPDATE 要求中設定,否則系統不會觸發通知。 |
app |
應用程式或網站連結 (選用) 會顯示為票證正面按鈕。如果為對應的物件提供 AppLinkData,系統會改用該值。 |
value |
選用值新增模組資料。類別上限為十個。對於通行證,系統只會顯示十個,並優先顯示物件中的通行證。 |
方法 |
|
---|---|
|
新增訊息至指定類別 ID 參照的儲值卡類別。 |
|
傳回具有指定類別 ID 的儲值卡類別。 |
|
插入具有指定 ID 和屬性的禮物卡類別。 |
|
傳回指定發卡機構 ID 的完整儲值卡類別清單。 |
|
更新指定類別 ID 參照的儲值卡類別。 |
|
更新指定類別 ID 參照的禮物卡類別。 |