Google Wallet API 可讓使用者透過網路將物件新增至 Google 錢包。 使用者可以直接從您的網站新增卡片。
本參考資料提供 HTML 元素 g:savetoandroidpay
的詳細資料,
顯示 Google Wallet API 按鈕
與 JSON Web Token
向 Google 說明您的網路服務
Google Wallet API JavaScript
如要自動剖析負載中的 g:savetoandroidpay
HTML 標記,請加入
JavaScript
<script src="https://apis.google.com/js/platform.js" type="text/javascript"></script>
如果是 True 應用程式,而且要明確呈現 Google Wallet API 按鈕,請加入 "parsetags": "explicit"
參數。
<script src="https://apis.google.com/js/platform.js" type="text/javascript"> {"parsetags": "explicit"} </script>
g:savetoandroidpay
HTML 標記
g:savetoandroidpay
命名空間標記會定義
刊登位置和各種屬性的
Google 電子錢包按鈕。如要轉譯 HTML 和 JWT,請使用這個標記
伺服器端代碼
<g:savetoandroidpay jwt="JWT" onsuccess="successHandler" onfailure="failureHandler" />
欄位 | 類型 | 必要 | 說明 |
---|---|---|---|
height |
字串 | 否 | 按鈕的顯示高度。可能的值包括:small (高 30 像素) 和
standard (高 38 像素)。height 預設為 small 。
請參閱 Google Wallet API 按鈕
查看採用不同 height 設定的按鈕範例。 |
jwt |
字串 | 是 | Google Wallet API JWT。 |
onsuccess |
字串 | 否 | 儲存成功回呼處理常式函式的字串名稱。 |
onfailure |
字串 | 否 | 儲存失敗回呼處理常式函式的字串名稱。系統會將 包含 errorCode 和 errorMessage 的錯誤物件。 |
onprovidejwt |
字串 | 否 | 提供 JWT 處理常式函式的字串名稱。這個函式的用途是
將物件新增至 Google 錢包前,可以攔截或視情況操控 JWT 資料。
此函式不使用任何參數,且必須傳回 JWT 做為字串。
導入事件處理常式時,可擷取原始 JWT 資料
欄位 this.getOpenParams().renderData.userParams.jwt 。 |
size |
字串 | 否 | 按鈕的顯示寬度。您可以將「size 」設為「matchparent 」
讓寬度符合父項元素的寬度。您也可以離開「size 」
未定義,這樣寬度會延展至 text 設定的寬度。
請參閱 Google Wallet API 按鈕
查看採用不同 size 設定的按鈕範例。 |
text |
字串 | 否 | 已淘汰 |
textsize |
字串 | 否 | 指定 textsize=large 時,會顯示
文字大小大幅增加
按鈕大小,適用於有特殊 UI 要求的情況。 |
theme |
字串 | 否 | 按鈕的顯示主題。可能的值包括:dark 和
light 。預設主題為 dark 。詳情請參閱
Google Wallet API 按鈕
查看採用不同 theme 設定的按鈕範例。 |
Google Wallet API JWT
Google Wallet API JWT 會定義要儲存的物件和類別。
JSON 表示法
{ "iss": "example_service_account@developer.gserviceaccount.com", "aud": "google", "typ": "savetowallet", "iat": 1368029586, "payload": { "eventTicketClasses": [{ ... //Event ticket Class JSON }], "eventTicketObjects": [{ // Event ticket Object JSON }], "flightClasses": [{ // Flight Class JSON }], "flightObjects": [{ // Flight Object JSON }], "giftCardClasses": [{ // Gift card Class JSON }], "giftCardObjects": [{ // Gift card Object JSON }], "loyaltyClasses": [{ // Loyalty Class JSON }], "loyaltyObjects": [{ // Loyalty Object JSON }], "offerClasses": [{ // Offer Class JSON }], "offerObjects": [{ // Offer Object JSON }], "transitClasses": [{ // Transit Class JSON }], "transitObjects": [{ // Transit Object JSON }] }, "origins": ["http://baconrista.com", "https://baconrista.com"] }
欄位
欄位 | 類型 | 必要 | 說明 |
---|---|---|---|
iss |
字串 | 是 | Google Cloud 服務帳戶產生的電子郵件地址。 |
aud |
字串 | 是 | 目標對象。Google Wallet API 物件的目標對像一律是
google 。 |
typ |
字串 | 是 | JWT 類型。Google Wallet API 物件的目標對像一律是
savetowallet 。 |
iat |
整數 | 是 | 核發時間,以秒為單位,自 Epoch 紀元時間起算。 |
payload |
物件 | 是 | 酬載物件。 |
payload.eventTicketClasses |
陣列 | 否 | 要儲存的活動票券類別。 |
payload.eventTicketObjects |
陣列 | 否 | 要儲存的活動票券物件。 |
payload.flightClasses |
陣列 | 否 | 要儲存的航班類別。 |
payload.flightObjects |
陣列 | 否 | 要儲存的航班物件。 |
payload.giftCardClasses |
陣列 | 否 | 要儲存的禮物卡類別。 |
payload.giftCardObjects |
陣列 | 否 | 要儲存的禮物卡物件。 |
payload.loyaltyClasses |
陣列 | 否 | 要儲存的會員類別。 |
payload.loyaltyObjects |
陣列 | 否 | 要儲存的會員物件。 |
payload.offerObjects |
陣列 | 否 | 要儲存的優惠物件。 |
payload.offerClasses |
陣列 | 否 | 要儲存的優惠類別。 |
payload.transitObjects |
陣列 | 否 | 要儲存的大眾運輸物件。 |
payload.transitClasses |
陣列 | 否 | 要儲存的大眾運輸類別。 |
origins |
陣列 | 是 | 要核准使用 JWT 儲存功能的網域陣列。Google Wallet API
如未定義 origins 欄位,就不會顯示按鈕。您可以
系統可能會顯示「Load denied by X-Frame-Options」或「拒絕顯示」訊息中的
,系統就會傳送快訊。 |
經過編碼的 JWT 應如以下範例所示:
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJnb29nbGUiLCJvcmlnaW5zIjpbImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly93d3cuZ29vZ2xlLmNvbSJdLCJpc3MiOiJzMmFwLXRvb2wuZ29vZ2xlLmNvbUBhcHBzcG90LmdzZXJ2aWNlYWNjb3VudC5jb20iLCJpYXQiOjE1NTE5ODcxNTEsInR5cCI6InNhdmV0b3dhbGxldCIsInBheWxvYWQiOnsib2ZmZXJPYmplY3RzIjpbeyJpZCI6IjMyMDI0MTMyNDE4NDM2OTk0MDEuMDFfT2ZmZXJPYmplY3RJZCJ9XX19.maHX40WWT29TC_kEb90EKQBH9AiTYAZR3153K8UI7fznVnfjVdlwsH_GKTECV3PGXdNnKCcmatUbKsONC0bxrnAHYG02kuvA1D3hSctz_amU66ntsvGIDe13mpxTzhI8fPvt9KMP1iaO7uOJuLQIHwipu4uRFAjyFaHGVaSFaP9c53qQyb_Zgyyk50M-MhH2n4kDpstNCqUJKWaadQkOWjrtMjwGzQ_ME04lbR4wb_mfK1A7Rc1UieWkxM9aMl5TOPubBKxKRRk_CqillN8XoTl9MI5RRGPuElVO28zGpYlFS6BarzDaaUfmbRZGvfF8ZiKrHZKxVrJjfZIJ2TCcDw
「gapi.savetoandroidpay.render
」函式
這個函式可讓您明確顯示 Google Wallet API 按鈕。
gapi.savetoandroidpay.render("dom-container",{ "jwt": "JWT", "onsuccess": "successHandler", "onfailure": "failureHandler" });
欄位 | 類型 | 必要 | 說明 |
---|---|---|---|
dom-container |
字串 | 是 | 用來放置 Google Wallet API 按鈕的容器 ID。 |
jwt |
字串 | 是 | 定義要儲存的內容的 JWT。 |
onsuccess |
字串 | 否 | 儲存成功回呼處理常式函式的字串名稱。 |
onfailure |
字串 | 否 | 儲存失敗回呼處理常式函式的字串名稱。系統會將 包含 errorCode 和 errorMessage 的錯誤物件。 |
onprovidejwt |
字串 | 否 | 提供 JWT 處理常式函式的字串名稱。這個函式的用途是
將物件新增至 Google 錢包前,可以攔截或視情況操控 JWT 資料。
此函式不使用任何參數,且必須傳回 JWT 做為字串。
導入事件處理常式時,可擷取原始 JWT 資料
欄位 this.getOpenParams().renderData.userParams.jwt 。 |
Google Wallet API 錯誤代碼和訊息
下表列出了該錯誤中傳遞的錯誤代碼和預設錯誤訊息 物件加入失敗回呼函式時,可以使用 JavaScript 按鈕成功儲存物件。
{ "errorCode": "errorCode", "errorMessage": "errorMessage" }
errorCode |
errorMessage |
---|---|
SERVICE_FAILURE |
Google 電子錢包伺服器發生錯誤。 |
CLASS_NOT_FOUND |
在物件中找不到參照的類別。 |
CLASS_MISMATCH |
物件必須存在、屬於相同類型,且必須參照封閉的類別。 |
ORIGIN_MISMATCH |
按鈕來源與來源清單中指定的來源不相符。 |
INVALID_NUM_TYPES |
您只能指定一種物件類型。 |
INVALID_SIGNATURE |
無法驗證簽名。 |
INVALID_DUPLICATE_IDS |
不允許重複的物件或類別。 |
INVALID_JWT |
JWT 無效。 |
INVALID_EXP_IAT |
JWT 已過期或日後核發。 |
INVALID_AUD |
AUD 欄位的值無效。 |
INVALID_TYP |
TYP 欄位的值無效。 |
INVALID_NUM_OBJECTS |
會員卡、禮物卡和優惠只能指定一個物件和最多一個類別。 |
MALFORMED_ORIGIN_URL |
來源網址的格式錯誤。網址必須包含通訊協定和網域。 |
MISSING_ORIGIN |
必須指定來源。 |
MISSING_FIELDS |
封閉的物件或類別缺少必填欄位。 |
本地化
JavaScript 按鈕中的語言會根據下列條件而改變:
- 如果使用者已登入 Google,按鈕則會以 使用者的 Google 帳戶個人資料。 使用者可以閱讀 變更語言 瞭解如何變更 Google 帳戶的偏好語言。
- 如果使用者未登入 Google,按鈕會使用
ACCEPT-LANGUAGE
值 。
如果您發現按鈕未根據上述邏輯以正確的語言顯示,或 遣詞用字不自然 聯絡支援團隊。