重要概念和術語

本文件列出使用 Google Wallet API 時應熟悉的常見術語和概念。

傳球次數


通過

「票證」是指核發給使用者的票證物件例項,以便儲存在 Google 錢包中。Google Wallet API 支援多種常見的票證類型,包括登機證、活動票券和身分證件等。Google Wallet API 也提供一般票證類型,可用於建立其他未特別支援的票證。

在多數情況下,系統會同時使用票證類別和票證物件建立票證。

票證核發者

「票證核發者」是一種實體,負責建立票證並發給使用者,以便儲存在 Google 錢包中。票證持有人擁有票證,並可建立、核發及更新票證。票證核發者可以是個別開發人員、公司和機構,也可以是代表他人建立並核發票證的集結網站,例如專門為零售商導入活動票券或優待券的公司。

瞭解詳情

票證類別

票證類別可視為票證建立時使用的共用範本。票證類別會定義使用於其所有票證中的特定屬性。票證核發者可以建立多個類別,每一種類別都有各自的專屬屬性組合,用於定義樣式和外觀等屬性,以及智慧感應、註冊和登入等其他功能。

在大多數情況下,系統會提供票證類別 (用於定義票證範本) 和票證物件來定義所核發個別票證的細節,藉此建立票證。

瞭解詳情

票證物件

「票證物件」會定義個別票證,這些票證會核發給使用者,以便儲存在 Google 錢包中。票證物件通常包含使用者專屬的資訊,舉例來說,票證類別可能會定義特定商店的禮物卡票證外觀,但「票證物件」會提供餘額或到期日等特定詳細資料。

您必須為收到的每張票證建立「票證物件」,不能建立多個票證類別可以共用的票證類別。

瞭解詳情

私人證件

使用 Google Wallet API 建立的某些票證可能含有使用者私密資料,這些票證需要額外的防護措施以保障使用者資料安全,且在 Google Wallet API 中透過一般私人證件進行管理的方式不同。一般私人證件應用於票證含有機密資料 (定義請見《Google Wallet API 使用限制政策》) 時,在加入票證的過程中,可能需要接受其他隱私權控制項和審查。

瞭解詳情

智慧感應功能

智慧感應功能是 Google 專屬的近距離通訊協定,可在行動裝置和 NFC 感應式刷卡機之間傳輸資料。智慧感應技術可讓使用者將手機貼近任何相容的 NFC 感應式刷卡機,藉此兌換儲存在 Google 錢包中的票證。

如要將智慧感應功能用於票證,你必須與支援智慧感應功能的感應式刷卡機供應商建立關係。

瞭解詳情

API 和 SDK


Google Wallet API

Google Wallet API 是 Google 提供的服務,可讓您建立並核發票證,以便使用者儲存在 Google 錢包中。這個 API 有數種用途,包括 Google Wallet REST API、Google Wallet Android SDK 和 Google 電子錢包控制台。

Google Wallet REST API

Google Wallet REST API 是可透過傳送 HTTP 要求至 Google Wallet API 的介面,以程式輔助的方式建立及管理票證。

如要使用 Google Wallet REST API,您還必須建立 Google Cloud 帳戶來建立服務帳戶,藉此驗證向 Google Wallet REST API 發出的要求。

Google 錢包 Android SDK

Google Wallet Android SDK 提供一系列便利的 Android 應用程式使用方法,例如建立和核發票證。

新增至 Google 錢包


「新增至 Google 錢包」按鈕

「新增至 Google 錢包」按鈕是 Google 核准的素材資源,用於向使用者展示票證。當使用者按一下或輕觸按鈕,系統會觸發「新增至 Google 錢包」連結,啟動將核發的票證新增至使用者的 Google 錢包的流程。

建議您盡量使用「新增至 Google 錢包」按鈕,因為這是使用者熟悉的 UI 元素,使用者已知道如何互動。

如要瞭解按鈕使用方式的資產和規範,請參閱 Google Wallet API 品牌規範

使用「新增至 Google 錢包」連結,即可透過一般超連結將票證核發給使用者。只要是能夠使用超連結的地方,都能使用,例如電子郵件、簡訊、網站和行動應用程式。

只要將已簽署的 JWT 附加至網址 https://pay.google.com/gp/v/save/,即可建立「新增至 Google 錢包」連結。

核發機構帳戶


展示模式

建立核發者帳戶之後,該帳戶會處於「展示模式」,直到獲準發布存取權為止。在展示模式中,你可以建立票證,但只能核發票證給具有核發者帳戶的「管理員」或「開發人員」角色的使用者,或是已在 Google 錢包控制台中新增為測試帳戶的使用者。

在「展示模式」中,您核發的所有票證標題會自動以「[僅限測試]」字樣開頭,表示票證僅供測試。

測試帳戶

核發者帳戶處於「示範模式」時,如果您要核發票證給沒有帳戶「管理員」或「開發人員」角色的任何使用者,則必須在 Google 錢包控制台中將他們新增為測試帳戶。註冊為測試帳戶的使用者可將你核發的票證新增至 Google 錢包。如要在「展示模式」中邀請更多目標對象測試票證,這項功能就能派上用場。

商家檔案

如要建立 Google Wallet API 的核發機構帳戶,您必須在註冊 Google Pay 和錢包主控台時設定企業付款資料。商家檔案會向 Google 提供公司或機構的基本資訊,您必須獲準發布才能發布內容。

瞭解詳情

發布存取權

你必須先獲準發布票證,使用者才能將票證儲存至 Google 錢包。如要獲準發布存取權,你必須建立至少一個票證類別,且具備完整的商家檔案。如果核發者想使用 Google 錢包 Android SDK 核發票證,就必須為應用程式提交 SHA-1 指紋。

如要申請發布存取權,請前往 Google 錢包控制台,按一下「要求發布存取權」按鈕。Google 電子錢包小組會審查您的要求,並在您取得發布權限時通知您。

瞭解詳情

驗證


JSON Web Token (JWT)

JSON Web Token 是常用的業界標準,能以 JSON 物件形式安全地傳輸資訊。使用 Google Wallet API 時,您必須將要用來建立 JWT (發音「草稿」) 格式的 Pass 物件詳細資料編碼,接著透過要求將 JWT 傳送至 Google Wallet API。

將 JWT 傳送至 Google Wallet API 之前,會先使用共用密鑰進行簽署,藉此保障他們的安全。如果您使用 Google Wallet REST API,簽署密鑰就是您的 Google Cloud 服務帳戶金鑰。如果您使用的是 Google 錢包 Android SDK,簽署密鑰就是 Android 應用程式的 SHA-1 指紋。

服務帳戶

Google Cloud 服務帳戶是一種特殊的帳戶,通常由應用程式或運算工作負載 (而非人員) 使用。在 Google Wallet API 中,您可以透過服務帳戶驗證傳送至 Google Wallet REST API 的要求。

服務帳戶需透過 Google Cloud 控制台建立。如要使用服務帳戶,您還需要在 Cloud 控制台中啟用 Google Wallet API,允許服務帳戶向 Google Wallet REST API 提出要求。

瞭解詳情

服務帳戶金鑰

服務帳戶金鑰是用來驗證 Google Wallet REST API 呼叫所需的憑證。服務帳戶金鑰具備高度機密性,請務必妥善保管,因為這個金鑰會透過 Google Wallet REST API,存取帳戶的許多票證核發者功能,包括建立票證類別和票證物件。

瞭解詳情

SHA-1 指紋

Android 應用程式簽署憑證的 SHA-1 指紋是您在使用 Google 錢包 Android SDK 時,用來驗證 Google Wallet API 呼叫的憑證。憑證的 SHA-1 指紋是透過 Gradle 或 keytool 產生。如要使用指紋來驗證要求,您必須在 Google 錢包控制台中註冊指紋。

瞭解詳情