背景
您現在可以更新物件和類別，以便納入附加價值商機模組。模組會顯示在詳細資料頁面上，並可連結至發布者內容。本文件將逐步說明如何使用 Google Wallet API 啟用及使用模組。
功能範例
|
|
| 單一檢視 | 清單檢視 |
以下指南假設您已熟悉 Google 錢包的基本概念，且已完成建議的前置條件。如有任何問題或意見，請與 Google 電子錢包 POC 聯絡。
整合步驟
如要新增模組，您必須更新物件和/或類別，以便納入 ValueAddedModuleData。ValueAddedModuleData 包含下列欄位：
[必要] LocalizedString 標頭
模組上顯示的標頭。字元限制為 60 個半形字元，過長的字串會遭到截斷。
LocalizedString 內容
模組上顯示的內文。字元上限為 50 個，超過此上限的字串會遭到截斷。
圖片圖片
模組上顯示的圖片。建議的圖片比例為 1:1，系統會調整圖片大小，以符合這個比例。
[必填] 字串 uri
使用者點選後模組導向的 URI。可以是網頁連結或深層連結。ModuleViewConstraints viewConstraints
顯示模組必須完全符合的限制。ModuleViewConstraints 具有下列欄位：TimeInterval displayInterval (時間間隔)
向使用者顯示模組的時間範圍。可以同時定義 `startTime` 和 `endTime`。除非設定 `startTime`，否則模組會在插入後立即顯示。如果未設定 `endTime`，則模組會無限期顯示。int32 sortIndex
用於排序模組的索引。排序索引較低的模組會顯示在排序索引較高的模組之前。如未指定，系統會假定排序索引為 INT_MAX。而對於具有相同索引的兩個模組，系統未定義其排序行為。ValueAddedModuleData 範例：
{
"valueAddedModuleData": [
{
"header": {
"defaultValue": {
"language": "en-US",
"value": "10% off merch"
}
},
"body": {
"defaultValue": {
"language": "en-US",
"value": "Shirts, caps, mugs, and more"
}
},
"image": {
"sourceUri": {
"uri": "http://www.images.google.com/opportunity"
}
},
"uri": "http://www.google.com/opportunity",
"viewConstraints": {
"displayInterval": {
"start": {
"date": "2024-08-01T18:30:00"
},
"end": {
"date": "2025-08-01T18:30:00"
}
}
},
"sortIndex": 0
},
{
"header": {
"defaultValue": {
"language": "en-US",
"value": "10% off concessions"
}
},
"uri": "http://www.google.com/new_opportunity"
}
]
}預期行為
成功更新物件和/或類別後，您現在會在對應的傳遞中看到模組。如果您只新增一個模組，系統會在票證正面顯示該模組。
附加商機模組的規範
模組可讓您透過額外動作提升使用者的票證體驗。建立及管理模組時，請考量以下幾點：
- 定義模組時，應使用適當的語言表示這些模組可供使用者操作，讓使用者瞭解這些模組可供點選。
- 模組應定義與特定模組相關的適當圖像。
- 您可以控管模組，並應根據重要性和相關性主動管理模組的優先順序。
- 請只顯示有效的使用者模組。您可以透過設定模組的 displayInterval，或主動在類別或物件中新增或移除 displayInterval，來控制這項功能。
例外狀況處理
| 訊息 | 原因 |
|---|---|
| ValueAddedModuleData 必須包含標頭。 | ValueAddedModuleData 沒有標頭。 |
| ValueAddedModuleData 必須包含非空白的 URI。 | ValueAddedModuleData 沒有非空白的 URI。 |
| 每門課程最多可新增 10 個加值模組。 | 需要減少課程的附加價值模組。 |
| 每個物件最多可加入 10 個附加價值模組。 | 需要減少物件上的附加價值模組。 |