パスを作成して署名付き JWT でエンコードしたら、[Google ウォレットに追加] リンクがサポートされている場所であればどこでも発行できます。これを行うには、[Google ウォレットに追加] ボタンまたはハイパーリンクをユーザーに表示します。ユーザーがこれをタップすると、パスが Google ウォレットに保存されます。この方法を使用できる場所の例としては、モバイルアプリ、ウェブサイト、メール、チャット、SMS などがあります。
前提条件
パスを発行する前に、次のことを行う必要があります。
- オンボーディング ガイドの手順をすべて完了します。
- 少なくとも 1 つのパスクラスを作成します。
- 1 つ以上のパス オブジェクトを作成します。
- パスクラスとパス オブジェクトを JWT でエンコードします。
- Google Cloud サービス アカウント キーを使用して JWT に署名します。
1. [Google ウォレットに追加] リンクを作成する
「Google ウォレット」リンクを使用してパスを発行すると、パス オブジェクトがユーザーの Google ウォレットに追加されます。この追加操作は、Google ID でログインしている状況でのみ開始できます。
[Google ウォレットに追加] リンクは、エンコードおよび署名された JSON Web Token(JWT)を含む、動的に生成される URL です。
[Google ウォレットに追加] リンクの形式は次のとおりです。
https://pay.google.com/gp/v/save/<signed_jwt>
たとえば、完全な形式の [Google ウォレットに追加] リンクは次のようになります。
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
このリンクは、モバイルアプリ、ウェブサイト、メール、チャット、SMS など、ハイパーリンクをサポートする場所であればどこにでも埋め込むことができます。
パスクラスとパス オブジェクトの作成について詳しくは、パスクラスとパス オブジェクトを作成するをご覧ください。
「Google ウォレットに追加」リンクの作成に必要な署名付き JWT を作成する方法については、JSON Web Token の操作をご覧ください。
2. (推奨)[Google ウォレットに追加] ボタンを使用する
ウェブサイトやメールなど、画像のハイパーリンクをサポートするサーフェスでは、[Google ウォレットに追加] ボタンを使用して [Google ウォレットに追加] リンクをユーザーに表示することをおすすめします。Google ウォレット ユーザーにとって、このボタンは Google ウォレットへのパスの追加を開始する方法として認識できる、見慣れたプロンプトです。
画像アセットは、Google Wallet API の統合をサポートするために、さまざまな向きと言語でダウンロードできます。
![[Google ウォレットに追加] ボタン](https://developers.google.cn/static/wallet/images/branding/add-to-wallet-button-primary.png?hl=ja)
![縮小形の [Google ウォレットに追加] ボタン](https://developers.google.cn/static/wallet/images/branding/add-to-wallet-button-condensed.png?hl=ja)