Google ウォレットには REST API が用意されており、HTTP 経由で Google Wallet API にリクエストを送信してパスの作成と管理を行うことができます。これは、プログラムでパスを操作するサーバーサイド サービスを構築する場合に役立ちます。
Google Wallet REST API を使用するには、Google Cloud コンソールで API を有効にして、Google Cloud サービス アカウントを作成して、サービス アカウントのキーを生成する必要があります。
REST API でパスを作成する場合、JSON ウェブトークンでエンコードされたパス オブジェクトの署名に使用されるサービス アカウント キー。
パスの更新や削除などの他のオペレーションでは、パス発行者としての認証リクエストとともにサービス アカウント キーが送信されます。
1. Google Wallet REST API を有効にする
Google Wallet REST API を有効にする手順は次のとおりです。
- Google Cloud アカウントをまだお持ちでない場合は、Google Cloud コンソールに移動し、手順に沿って新しいアカウントを登録します。
- コンソールの上部にあるプロジェクトのプルダウン メニューから、使用する Google Cloud プロジェクトを選択するか、新しいプロジェクトを作成します。
- Google Cloud コンソールの Marketplace で Google Wallet API プロダクトの詳細ページに移動します。
- [有効にする] ボタンをクリックします。しばらくすると、選択した Google Cloud プロジェクトで Google Wallet REST API が使用可能になります。
2. Google Cloud サービス アカウント キーを生成する
Google Wallet REST API へのリクエストを認証するには、次の手順でサービス アカウントを作成し、サービス アカウント キーを生成する必要があります。
- Google Cloud コンソールで [サービス アカウントの作成] ページに移動します。
- サービス アカウントの詳細を入力します。[サービス アカウント ID] フィールドの下に表示されるサービス アカウントのメールアドレスをメモします。これは、後でサービス アカウントを使用して Google Wallet REST API へのリクエストを認証するときに必要になります。
- [完了] ボタンをクリックします。他のサービス アカウントの作成手順を完了する必要はありません。
- ページ上部の [キー] メニュー項目をクリックします。
- [鍵を追加] プルダウン メニューをクリックし、[新しい鍵を作成] をクリックします。
- 鍵のタイプとして [JSON] を選択します。
- [作成] をクリックしてサービス アカウント キーを作成し、ダウンロードします。
3. Google ウォレット コンソールでサービス アカウントを承認する
サービス アカウント キーを使用して Google Wallet REST API へのリクエストを認証するには、サービス アカウントのメールアドレスをユーザーとして発行者アカウントに追加する必要があります。サービス アカウントをユーザーとして追加するには、次の操作を行います。
- Google Cloud コンソールで [サービス アカウント] ページに移動します。
- Google Wallet API へのリクエストの認証に使用するサービス アカウントのメールアドレスをコピーします。
- Google Pay & ウォレット コンソールに移動します。
- 左側のナビゲーションで [ユーザー] をクリックします。
- [ユーザーを招待] をクリックします。
- サービス アカウントのメールアドレスを入力します。
- [アクセスレベル] プルダウンで [デベロッパー] を選択します。
- [招待] ボタンをクリックします。
サービス アカウントが追加されると、そのアカウント用に生成されたサービス アカウント キーを使用して、Google Wallet REST API へのリクエストを認証できます。サービス アカウント キーを使用する場合は、これらは機密性の高い認証情報であるため、安全なサーバーサイド環境でのみ使用してください。