必備條件

在開始與 Google Wallet API 整合之前，請完成下列步驟：

1. 註冊 Google Wallet API 發卡機構帳戶

如要建立及發布 Google 錢包票證，您必須具備發卡機構帳戶。註冊 Google Pay 和錢包主控台，即可取得發卡機構帳戶。註冊後，前往「Google Wallet API」頁面，然後按一下「建立您的第一張票證」。接受服務條款後，即可開始建立票證類別。

完成上述步驟後，您也可以試用程式碼研究室。

2. 熟悉在 Android 平台上開發應用程式的做法

基於本教學課程的目的，請先熟悉 Android 平台開發應用程式的基本概念和技能。如果您需要在開始前先瞭解 Android 開發流程，請前往 Android 開發人員培訓資源頁面瀏覽相關課程。

3. 取得憑證來授權應用程式

如要在 Android 應用程式中順利使用 Google Wallet API for Android，請授權您的應用程式。方法是使用開發人員金鑰中的 SHA1 指紋和套件名稱。

您必須取得憑證的 SHA1 指紋，才能獲得核准。如要尋找指紋，請開啟終端機視窗並執行 Keytool 公用程式：

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

偵錯 KeyStore 通常位於 ~/.android/debug.keystore，密碼為 android。

Keytool 會將指紋列印到殼層中。範例如下： 

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

4. 在 Google Pay 和錢包主控台中授權應用程式

複製上述範例中醒目顯示的 SHA1 指紋。您需要應用程式的指紋和套件名稱才能授權應用程式。完成下列步驟即可授權應用程式：

  1. 前往 Google Pay 和錢包主控台
  2. 在左側選單中選取「Google Wallet API」
  3. 選取「其他功能」分頁標籤
  4. 向下捲動至「應用程式權限」部分
  5. 按一下「新增應用程式」按鈕
  6. 輸入套件名稱和簽名金鑰指紋
  7. 按一下「Add application」按鈕
完成上述步驟後，您的應用程式套件現已獲得授權，您可以在「應用程式權限」部分查看應用程式套件。

5. 設定 Google Play 服務

如果您還沒有 Android Studio，請下載並安裝 Android Studio。

Android 版 Google 錢包屬於 Google Play 服務的一部分。如要匯入 Google Play 服務程式庫，請按照操作說明設定 Google Play 服務。

具體而言，如要匯入 Android 版 Google Wallet API，請將以下內容新增至應用程式模組的 build.gradle 檔案依附元件區塊：

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

6. 建立票證類別

你必須先建立 GiftCardClass，才能建立及新增禮物卡。方法是登入 Google Pay 和錢包主控台，前往 Google Wallet API 頁面，然後建立新的 GiftCardClass。

  1. 確認目前位於「管理」分頁
  2. 如果您是第一次建立票證，畫面上應該會顯示「You're in demo mode」。
  3. 在示範模式中，按一下「設定測試帳戶」新增測試帳戶。 核發機構帳戶處於示範模式時，只有這些帳戶可以儲存票證。
  4. 按一下「建立課程」。
  5. 選擇「禮物卡」
  6. 填寫所有標有 * 的必填欄位
  7. 按一下「建立課程」

如需多張禮物卡，請重複上述步驟。

現在你已成功建立 GiftCardClass，可以繼續前往將票證新增至 Google 錢包。