Google Wallet API 常見問題

開始使用

什麼是 Google Wallet API？

開發人員可透過 Google Wallet API 在 Google 錢包中建立數位票證。Google 錢包 API 目前支援登機證、活動票券、會員卡、優惠和大眾運輸票證。最近，我們新增了泛型憑證類型，支援更多用途。

如何根據業務需求和複雜度設定開發環境？

以下指南可協助您設定開發環境，因應不同程度的業務複雜度和安全性。開發人員可使用多個服務帳戶，建立與 PROD 環境分開的 TEST 環境。

基本設定複雜度

1 個商家控制台帳戶或 1 個商家控制台父項帳戶對應多個發卡機構帳戶。

  • 這個選項可讓您使用 1 個主要帳戶，集中管理零到多個子商家/發行者。
  • 1 個 Google Cloud 專案。
  • 1 個服務帳戶憑證。
  • 單一使用者群組。

平均設定複雜度

1 個上層帳戶對應多個發行機構帳戶。

  • 這個選項可讓您使用 1 個主要帳戶，集中管理多個子商家。
  • 1 個 Google Cloud 專案。
  • 每個發行者都有專屬的商家控制台使用者。
  • 一或多個服務帳戶憑證。
    • 每個商家/核發機構 1 項憑證。
    • 每個商家有不同的憑證存取權。

設定複雜度高

1 個上層帳戶對應多個發卡機構帳戶。

  • 這個選項可讓您使用 1 個主要帳戶，集中管理多個子商家。
  • 1 個或多個 Google Cloud 專案。
  • 每個發行者都有專屬的商家控制台使用者。
  • 一或多個服務帳戶憑證。
    • 每個商家/發行者 1 個 PROD 憑證。
    • 每個商家/發行者 1 個開發人員憑證。

與支援團隊聯絡

使用票證

如何刪除類別或物件？

目前無法從 Google 錢包刪除類別或物件。不過，使用者可以取消物件與 Google 錢包的連結。

如何將多張票證分組？

使用 GroupingID 可輕鬆將票證分組。

如何只更新票證的部分內容？

請參閱效能指南，瞭解如何使用 PATCH 要求執行部分更新。

可以批次建立票證嗎？

請參閱效能指南，瞭解如何使用 API 執行批次要求。

一般問題

傳送至 Google Wallet API 的要求頻率上限為何？

Google Wallet API 的呼叫頻率上限為每秒 20 個要求。

Google 錢包 API 沒有正式的服務水準協議，但根據約 5 秒的第 99 個百分位數延遲時間，我們建議將逾時時間設為 10 秒。此外，請注意，延遲時間通常取決於外部因素，例如插入含有該圖片的物件時，擷取外部伺服器上託管圖片所需的時間，因為這取決於外部伺服器的延遲時間。

為什麼 Google 錢包憑證禁止顯示個人圖片？

根據現行法規，所有消費者都有權選擇不讓商家收集或處理私密資料，因此 Google 錢包不支援在票證上顯示個人圖片。如果將私密資料 (個人圖片) 納入有價值的物件 (JWT)，可能會出現代管問題，導致資料公開，超出原始同意聲明的範圍。為確保資料機密性，請勿上傳個人圖片。我們正努力在日後支援個人圖片。

Google Wallet API 會傳回哪些錯誤代碼？

如要查看 Google Wallet API 傳回的錯誤代碼和例外狀況清單，請參閱「錯誤代碼」。

如何啟用推播通知？

Google 錢包目前不支援開發人員撰寫的推播通知。 不過，Google 錢包會針對下列票證提供即時通知。 Google 錢包目前不支援開發人員撰寫的推播通知。

產業 通知 已觸發 說明文件
事件 有即將到來的提醒 活動前 3 小時 文件
登機證 有即將到來的提醒 航班起飛前 3 小時 文件
登機證 更新票證 出發地航廈、登機門、登機時間或出發時間變更 文件
優惠卡 到期提醒 優惠卡到期前 48 小時 文件
通用 有即將到來的提醒 「時間間隔」開始前 24 小時 文件
通用 到期提醒 「時間間隔」結束前 48 小時 文件

可以刪除商家 ID 嗎？

目前無法從 Google Pay 和錢包主控台刪除或封存商家 ID。

如何使用 Applinking 功能？

應用程式連結需要加入許可清單，您可以在這裡提出要求。

Google 錢包是否支援地理圍欄？

目前不支援地理圍欄。

如何設定會員方案？

如要設定註冊和會員方案，請參閱這份指南。

如何將大眾運輸票證的標誌傳送給 Google？

請填寫這份表單，將標誌傳送給 Google 進行許可清單作業。

如何正確處理採用 Base64 編碼的 userProfile 資料？

請確認你在開發時全程採用 UTF-8 編碼。JSON 字串會先以 UTF-8 編碼，再以 android.util.Base64 編碼，並提供 NO_WRAP 和 URL_SAFE。 (符合 RFC 3548 第 4 節的規定)。

如何透過程式建立核發機構帳戶？

如要透過 API 建立發卡機構帳戶，請參閱這份指南。

智慧感應

我是否需要使用特殊的 NFC 讀取器，才能讀取 Google SmartTap 票證？

感應式刷卡機必須支援智慧感應功能。如要查看認證供應商清單，請按這裡。

如何使用 NFC 感應票證？

請按照這項設定啟用智慧感應兌換票證功能。

JSON Web Token (JWT)

是否有任何工具能簡化 JWT 的實作和偵錯作業？

有。www.jwt.io 等平台可讓你在開發過程中為權杖解碼並進行偵錯，方便你驗證要提交的內容。請注意，Google 與該網站並無任何聯盟關係，也未特別推薦你採用這類第三方服務。

您可以在建立儲存票證連結 (JWT) 前，使用 API 預先建立類別和物件 。

疑難排解

為什麼我的時間設定顯示的活動時間有誤？

票證上顯示的時間是活動當地時間，並會根據活動地點的時區進行調整。

我建立的票證不會顯示標誌。問題可能出在什麼地方？

  • 首先，請確認標誌符合規範，並以 PNG 格式儲存。
  • 確保標誌隨時可用，且可靠度高。請勿重新導向至圖片檔案，否則可能會導致 404 錯誤。圖片託管網址必須採用 HTTPS 通訊協定，否則將無法在 Google 錢包中顯示。
  • 確認在票證中設定了 API 中標示為必填的所有欄位。

支援與意見回饋

如何聯絡技術支援團隊？

如需其他協助，請在 Google Pay 和 Google 錢包控制台的左側邊欄中，按一下「聯絡支援團隊」按鈕，與支援團隊聯絡。

如何提供產品意見回饋？

如要提供產品意見，請按一下開發人員網站頁面右上象限的「提供意見」按鈕，然後選取「產品意見」。接著，在文字區域中說明你的意見回饋，然後按一下「傳送」。

如何提供說明文件意見回饋？

如要提供說明文件意見，請點選開發人員網站頁面右上象限的「提供意見」按鈕，然後選取「說明文件意見」。接著，在文字區域中說明你的意見，然後按一下「傳送」。