Google Wallet API 常見問題

開始使用

什麼是 Google Wallet API？

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

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

以下指南可協助您設定開發環境，因應不同層級的業務複雜性和安全性。使用多個服務帳戶可讓開發人員建立與正式環境分開的測試環境。

基本設定的複雜度

1 個商家控制台帳戶或 1 個商家控制台上層帳戶，可連結至多個發卡機構帳戶。

  • 這個選項可讓您使用 1 個主要帳戶，搭配 0 個或多個子商家/發卡機構，實現集中管理。
  • 1 項 Google Cloud 專案。
  • 1 個服務帳戶憑證。
  • 單一使用者群組。

平均設定複雜度

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

  • 這個選項可讓您使用 1 個主要帳戶和多個子商家，採用集中管理的方式。
  • 1 項 Google Cloud 專案。
  • 每個發證機構的獨立商家控制台使用者。
  • 1 對多個服務帳戶憑證。
    • 每位商家/發卡機構只能取得 1 個憑證。
    • 每間商家都有不同的憑證存取權。

複雜的設定

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

  • 這個選項可讓您使用 1 個主要帳戶和多個子商家，採用集中管理的方式。
  • 1 對多個 Google Cloud 專案。
  • 每個發證機構的獨立商家控制台使用者。
  • 1 對多個服務帳戶憑證。
    • 每個商家/發證者 1 個正式版憑證。
    • 每間商家/發證者 1 個開發人員憑證。

與支援團隊聯絡

使用票證

如何刪除類別或物件？

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

如何將多張票證分組？

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

如何僅更新票證的部分資訊？

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

我可以批次建立票證嗎？

請參閱成效指南，瞭解如何使用 API 執行大量要求。

一般問題

傳送至 Google Wallet API 的要求有哪些頻率限制？

向 Google Wallet API 發出的呼叫，要求傳送頻率上限為每秒 20 次。

為什麼 Google 錢包中的票證禁止使用個人圖片？

Google 錢包不支援票證中的個人圖片，因為現行法規已聲明，所有消費者有權選擇不收集或處理機密資料。將私密資料 (個人圖片) 做為重要物件 (在 JWT 中) 後，可能就會造成代管疑慮，導致資料變成了原始同意聲明協議之外的公開內容。為確保資料機密性，我們不允許使用個人圖片。我們會在日後支援個人圖片。

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

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

如何啟用推播通知？

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

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

商家 ID 可以刪除嗎？

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

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

應用程式連結功能需要申請加入許可清單，請前往這個頁面申請。

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

目前不支援地理圍欄。

如何設定會員方案？

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

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

請使用這份表單，將標誌傳送給 Google 以便加入許可清單。

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

請確認你在開發時全程採用 UTF-8 編碼。JSON 字串開頭採用 UTF-8 編碼，隨後則採用具備 NO_WRAP 和 URL_SAFE 選項的 android.util.Base64 編碼。(符合 RFC 3548 第 4 節的規定)。

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

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

智慧感應功能

我需要使用特殊的 NFC 讀卡機才能使用 Google 智慧觸碰票證嗎？

必須是支援智慧感應功能的終端機。如要查看認證供應商清單，請按這裡。

如何讓票證支援 NFC？

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

JSON Web Token (JWT)

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

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

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

疑難排解

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

票證上顯示的時間是活動當地的當地時間，並加上活動所在時區的時間偏差。

我的標誌無法在已建構的票證上顯示。問題可能出在哪裡？

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

支援和意見回饋

如何與技術支援人員聯絡？

如需其他協助，請按一下 Google Pay 和錢包資訊主頁左側面板中的「與支援團隊聯絡」按鈕，與支援團隊聯絡。

如何提供產品意見回饋？

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

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

如要提供說明文件意見回饋，請按一下開發人員網站頁面右上方區塊中的「Send Feedback」(提供意見) 按鈕，然後選取「Documentation feedback」(說明文件意見回饋)。接著，在文字方塊中說明意見回饋，然後按一下「傳送」。