資源:GenericObject
一般物件
JSON 表示法 |
---|
{ "genericType": enum ( |
欄位 | |
---|---|
genericType |
指定卡片所屬的 |
cardTitle |
必要欄位。票證的標頭。通常是商家名稱,例如「XXX Gym」、「AAA 保險」。此為必填欄位,且會顯示在票證頂端的標題列中。 |
subheader |
票證的標題標籤,例如可以使用這張票證的地點。顯示在票證詳細資料檢視畫面中的標題列上方。 |
header |
必要欄位。票證的標題,例如「優待券 5 折優惠」、「媒體庫卡」或「優待券」。此為必填欄位,會顯示在票證詳細資料檢視畫面的標題列中。 |
logo |
票證的標誌圖片。這張圖片會顯示在左上角的資訊卡詳細資料檢視畫面,以及清單/縮圖檢視畫面。如果沒有標誌, |
hexBackgroundColor |
資訊卡的背景顏色。如未設定,則會使用主頁橫幅的主要顏色;如果未設定主頁橫幅,則會使用標誌的主要顏色;如果未設定標誌,Google 便會選擇顏色。 |
notifications |
這個物件已啟用的通知設定。 |
id |
必要欄位。物件的專屬 ID。特定核發者的所有物件 ID 都不得重複。這個值必須符合 |
classId |
必要欄位。與這個物件相關聯的類別。必須是與這個物件相同的類型、已存在,而且必須經過核准的類別。 類別 ID 應依循 |
barcode |
條碼類型和值。如果票證沒有條碼,我們允許核發機構設定 Barcode.alternate_text,並只顯示該條碼。 |
heroImage |
卡片正面顯示的橫幅圖片 (如有)。圖片將以 100% 寬度顯示。 |
validTimeInterval |
這個物件會被視為有效或可使用的時間範圍。超過時間範圍時,系統會將物件視為過期,進而影響使用者裝置上的算繪作業。 |
imageModulesData[] |
圖片模組資料。當兩者都設定時,系統只會算繪類別中的一張圖片,另一張來自物件層級的圖片。 |
textModulesData[] |
文字模組資料。如果類別中也定義了 |
linksModuleData |
連結模組資料。如果類別中也定義了 |
appLinkData |
選用的應用程式或網站連結,會顯示在票證正面的按鈕中。如果為對應的類別提供 AppLinkData,系統就會顯示 AppLinkData。 |
groupingInfo |
控管票證分組方式的資訊。 |
smartTapRedemptionValue |
系統會透過 NFC 為這個物件傳輸透過智慧感應功能認證的感應式刷卡機。此外,類別層級 |
rotatingBarcode |
輪替條碼設定/詳細資料。 |
state |
物件狀態。這個欄位可用來判斷物件在應用程式中的顯示方式。舉例來說, |
hasUsers |
指出這個物件是否有使用者。這個欄位是由平台設定。 |
passConstraints |
傳遞物件的限制條件。包括限制 NFC 和螢幕截圖的行為。 |
wideLogo |
票證的寬標誌。提供此設定會用來取代資訊卡檢視左上方的標誌。 |
GenericType
一般資訊卡的類型。
列舉 | |
---|---|
GENERIC_TYPE_UNSPECIFIED |
未指定泛型類型。 |
GENERIC_SEASON_PASS |
整季節目憑證 |
GENERIC_UTILITY_BILLS |
公用事業費帳單 |
GENERIC_PARKING_PASS |
停車證 |
GENERIC_VOUCHER |
優待券 |
GENERIC_GYM_MEMBERSHIP |
健身房會員卡 |
GENERIC_LIBRARY_MEMBERSHIP |
借書證 |
GENERIC_RESERVATIONS |
預留項目 |
GENERIC_AUTO_INSURANCE |
汽車保險卡 |
GENERIC_HOME_INSURANCE |
住宅保險卡 |
GENERIC_ENTRY_TICKET |
門票 |
GENERIC_RECEIPT |
收據 |
GENERIC_OTHER |
其他類型 |
通知
指出物件是否需要啟用通知。我們只支援一項 ExpiryNotification/近期通知。expiryNotification
的優先順序高於 upcomingNotification
。換句話說,如果已設定 expiryNotification
,系統會忽略 upcomingNotification
欄位。
JSON 表示法 |
---|
{ "expiryNotification": { object ( |
欄位 | |
---|---|
expiryNotification |
系統會在卡片到期前的特定時間點觸發通知。 |
upcomingNotification |
系統會在資訊卡可使用前的特定時間觸發通知。 |
ExpiryNotification
表示發卡機構希望 Google 錢包在卡片到期前 2 天傳送到期通知。
JSON 表示法 |
---|
{ "enableNotification": boolean } |
欄位 | |
---|---|
enableNotification |
指出物件是否需要啟用到期通知。 |
UpcomingNotification
表示發卡機構希望 Google 錢包在卡片生效/可使用的 1 天前,傳送即將生效的卡片有效通知。
JSON 表示法 |
---|
{ "enableNotification": boolean } |
欄位 | |
---|---|
enableNotification |
指出物件是否需要啟用近期通知。 |
方法 |
|
---|---|
|
在指定物件 ID 參照的一般物件中新增訊息。 |
|
傳回具有指定物件 ID 的泛型物件。 |
|
插入具有指定 ID 和屬性的泛型物件。 |
|
傳回指定核發者 ID 的所有通用物件清單。 |
|
更新指定物件 ID 參照的泛型物件。 |
|
更新指定物件 ID 參照的泛型物件。 |