Google Pay API for Passes 的 Android API 快速入門

透過 Google Pay API for Passes 的 Android API，使用者只要按一下按鈕，即可將有價值物件儲存至 Google Pay。這個快速入門範例提供簡單的設定步驟，可用於儲存會員卡、禮物卡和優惠物件。

請參閱 Android SDK 指南，然後按照下列步驟執行範例 Android 應用程式：

步驟 1：設定 Android 應用程式

這個快速入門範例是一項開放原始碼專案，可從 GitHub 下載。下載此專案的方式如下：

  1. 前往 GitHub 存放區。
  2. 下載 zip 檔案或執行 git clone https://github.com/google-pay/s2gp-quickstart-android 來複製存放區。

接著，您可以透過 Android Studio，將這個範例應用程式當做現有專案開啟。專案可能需要經過同步處理才能正確編譯。在 Android Studio 中建立範例應用程式後，即可在 Android 裝置或模擬器上執行應用程式。

步驟 2：建立類別

您可透過 Google Pay API for Passes Merchant Center 來建立類別，方法是從 Merchant Center 的「類別」頁面選取 [建立類別]。具有紅色外框的輸入欄位為必填，其餘欄位則為選填。針對所有具有網址的欄位，請確認連結可公開存取。建立重要物件時，系統會參照已建立的類別。

步驟 3：設定 Android 應用程式

如要設定範例應用程式，讓應用程式可正確運作，您必須調整某些值。在 app/res/values/ 中的 strings.xml 內：

  1. 將 ISSUER_ID 的值改成您的 Google Pay API for Passes 核發機構 ID。
  2. 將 LOYALTY_CLASS_ID、GIFTCARD_CLASS_ID 或 OFFER_CLASS_ID 改成已在您所要且已在 Google Pay API for Passes Merchant Center 中建立的類別名稱。

在 MainActivity.java 中，您必須為各個物件類型設定的某些值，讓這些值與物件在 Merchant Center 中參照的類別一致：

  1. 針對 generateGiftCardWalletObject 方法中的 GiftCardWalletObject，setIssuerName 和 setTitle 必須與類別中的值一致。
  2. 針對 generateLoyaltyWalletObject 方法中的 LoyaltyWalletObject，setIssuerName 和 setProgramName 必須與類別中的值一致。
  3. 針對 generateLoyaltyWalletObject 方法中的 OfferWalletObject，setIssuerName 和 setTitle 必須與類別中的值一致。

步驟 4：測試 Android 應用程式

您可以透過模擬器或實體 Android 裝置執行應用程式。Gradle 經過妥善同步處理後，請透過 Android Studio 執行應用程式，並選擇所需的部署目標。部署完成後，範例應用程式應會自動啟動。