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 專案。
  • 各發卡機構不同的 Business Console 使用者。
  • 1 至多個服務帳戶憑證。
    • 每個商家/核發者只能取得 1 個憑證。
    • 每個商家的憑證存取權都不同。

複雜的設定程序

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

  • 這個選項可讓你透過 1 個主要帳戶集中管理多個子商家。
  • 1 至多項 Google Cloud 專案。
  • 各發卡機構不同的 Business Console 使用者。
  • 1 至多個服務帳戶憑證。
    • 每位商家/核發者 1 個 PROD 憑證。
    • 每個商家/發卡機構 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?

請使用這份表單,將標誌送交 Google 許可清單。

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

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

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

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

智慧感應功能

我需要使用特殊的 NFC 讀卡機才能使用 Google SmartTap 票證嗎?

必須是支援 SmartTap 的終端機。如需認證供應商名單,請參閱這篇文章

如何讓票證能與 NFC 搭配使用?

請遵照這項設定,將您的票證設為可兌換的智慧感應功能。

JSON 網路權杖 (JWT)

是否有工具能簡化 JWT 實作和偵錯程序?

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

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

疑難排解

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

票證上顯示的時間是活動當地時間,並採用活動時間的偏移值。

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

  • 首先,請確保您的標誌符合規範,並以 PNG 格式儲存。
  • 確認標誌在可正常運作的情況下,且具備高度可靠性。請勿重新導向至可能導致 404 錯誤的圖片檔。您的圖片必須存放在 HTTPS 位置,否則將無法在 Google 錢包中顯示。
  • 確保在 API 中標示為必填的所有必填欄位都已設定在票證中。

支援和意見回饋

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

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

如何留下產品意見回饋?

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

如何留下說明文件意見回饋?

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