1. 註冊應用程式

凡是要存取 Google API 的應用程式,都必須透過 API 控制台註冊。註冊後會產生一組值,只有 Google 和您的應用程式知道這項資訊 (包括用戶端 ID、電子郵件地址和私密金鑰)。如何註冊應用程式:

  1. 申請取得 Google Pay API for Passes 的存取權。如果您已申請過,可以略過這個步驟。
  2. 前往 API 控制台
  3. 按一下 [建立專案] 按鈕,或在頁面頂端的下拉式選單中選取 [建立專案]。畫面上會顯示「新專案」頁面。
  4. 輸入專案名稱。
  5. 按一下 [建立]。設定完成後,右上角會顯示通知。按一下這則通知即可前往專案的首頁。
  6. 按一下 [前往 API 總覽],然後點選 [啟用 API 和服務]
  7. 搜尋「Google Pay Passes API」,然後點選 [啟用]
  8. 按一下左側選單中的 [憑證]
  9. 按一下 [建立憑證] 按鈕,然後選取 [服務帳戶金鑰]
  10. 在頁面中建立服務帳戶金鑰;您可能也需要在此建立服務帳戶。這個服務帳戶不需要其他角色。選擇 [json] 做為金鑰類型,然後點選 [建立]。
  11. 系統已在您的帳戶清單中新增一個服務帳戶,並將私密金鑰下載到您的本機檔案系統。此為這組金鑰的唯一複本,您必須負責將這個金鑰檔案存放在安全的位置。您稍後將用到這組金鑰。
  12. 在「憑證」分頁中按一下 [管理服務帳戶],然後找出金鑰的服務帳戶電子郵件地址並複製起來。您稍後將用到這個地址。

警告:您必須為開發人員和正式版環境妥善儲存及管理私密金鑰。Google 的伺服器上只有存放公開金鑰的複本。 如要進一步瞭解如何管理服務帳戶私密金鑰,請參閱這個頁面

2. 將服務帳戶連結至您的 Google Pay API for Passes 帳戶

您的 Google 聯絡窗口應已為您建立 Google Pay API for Passes 帳戶。您可以透過 Google Pay API for Passes Merchant Center 網站管理您的帳戶和所有相關類別與物件。請按照下列步驟操作,將服務帳戶連結至 Google Pay API for Passes Merchant Center:

  1. 前往 Google Pay API for Passes Merchant Center
  2. 從清單中選取您的帳戶。畫面上會顯示「帳戶資訊」頁面。
  3. 按一下 [分享],畫面上會顯示分享設定。
  4. 註冊應用程式一節,找出您建立金鑰時所用的服務帳戶電子郵件地址 (結尾是 @<your_domain>.iam.gserviceaccount.com),然後將其複製並貼入 Invite people 欄位。
  5. 確認權限下拉式選單已設為 [可編輯],然後按一下 [傳送]。服務帳戶現已連結至您的 Google Pay API for Passes 帳戶,您現在可向 API 執行 REST 呼叫。