Google Wallet API 常見問題

開始使用

什麼是 Google Wallet API?

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

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

以下指南有助您根據不同程度的業務複雜度和安全性,設定適合的開發環境。使用多個服務帳戶可讓開發人員在 PROD 環境之外建立測試環境。

基本設定複雜度

1 個企業控制台帳戶或 1 個企業控制台上層帳戶,可連結至多個發卡機構帳戶。

  • 這個選項可讓你集中管理 1 個主要帳戶,且沒有任何子公司/發卡機構。
  • 1 項 Google Cloud 專案。
  • 1 個服務帳戶憑證。
  • 單一使用者

平均設定複雜度

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

  • 這個選項可讓你集中管理 1 個主要帳戶 (內含許多子商家的)。
  • 1 項 Google Cloud 專案。
  • 每個發卡機構都有不同的企業控制台使用者。
  • 1 至多組服務帳戶憑證。
    • 每個商家/發卡機構只能擁有 1 組憑證。
    • 每個業務都有不同憑證存取權。

複雜的設定

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

  • 這個選項可讓你集中管理 1 個主要帳戶 (內含許多子商家的)。
  • 1 至多項 Google Cloud 專案
  • 每個發卡機構都有不同的企業控制台使用者。
  • 1 至多組服務帳戶憑證。
    • 每個商家/發卡機構只能取得 1 份執照認證。
    • 每個商家/發卡機構只能取得 1 組 DEV 憑證。

與支援團隊聯絡

使用票證

如何刪除類別或物件?

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

如何將多張票證分組?

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

如何只更新部分票證?

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

我可以批次建立票證嗎?

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

一般問題

傳送至 Google Wallet API 的要求頻率限制為何?

呼叫 Google Wallet API 的頻率上限為每秒 20 次。

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

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

如何啟用推播通知?

Google 錢包目前不支援由開發人員撰寫的推播通知。 不過,Google 錢包會針對下列票證及時發出通知。Google 錢包目前不支援由開發人員撰寫的推播通知。

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

可以刪除商家 ID 嗎?

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

如何使用應用程式連結功能?

如要進行應用程式連結,請按這裡

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

目前不支援地理圍欄。

如何設定會員方案?

請按照這份指南設定註冊和會員方案。

如何將大眾運輸票證的標誌傳送至 Google?

請使用這份表單將標誌加入許可清單,以便將標誌加入許可清單。

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

請務必使用 UTF-8 編碼。JSON 字串開頭採用 UTF-8 編碼,隨後則採用 android.util.Base64 編碼,並提供 NO_WRAP 和 URL_SAFE。 (符合 RFC 3548 第 4 節的規定)。

如何透過程式建立發卡機構帳戶?

請參閱這份指南,瞭解如何透過 API 建立核發機構帳戶。

智慧感應功能

Google Smart Tap 票證需要特別的 NFC 讀卡機嗎?

該配件必須是支援智慧感應功能的感應式刷卡機。如需已認證的供應商清單,請按這裡

如何透過 NFC 使用我的票證?

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

JSON Web Token (JWT)

有哪些工具能簡化 JWT 的實作和偵錯作業?

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

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

疑難排解

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

票證上顯示的時間是事件的當地時間,事件所在時間的偏移量。

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

  • 首先,請確認標誌符合規範,且以 PNG 格式儲存。
  • 因此標誌圖示清晰可辨,而且穩定性高。請勿重新導向至可能導致 404 錯誤的圖片檔。您的圖片必須存放在 HTTPS 位置,否則將無法在 Google 錢包中顯示。
  • 請確認已在票證中設定所有 API 中標示為必填的必填欄位。

支援和意見回饋

我要如何與技術支援人員聯絡?

如需其他協助,請點選 Google Pay 和錢包主控台左側欄中的「與支援團隊聯絡」按鈕,與支援團隊聯絡。

如何提供產品意見回饋?

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

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

如要提供說明文件意見回饋,請按一下開發人員網站頁面右上方的「提供意見」按鈕,然後選取「說明文件意見回饋」。接著,在文字區域中說明您的意見,然後按一下 [傳送]。