このドキュメントでは、Google Wallet API を使用する際に知っておくべき一般的な用語と概念について説明します。
パス数
合格
パスは、Google ウォレットに保存するためにユーザーに発行されるパス オブジェクトのインスタンスです。Google Wallet API は、搭乗券、イベント チケット、ID カードなど、多くの一般的なパスタイプをサポートしています。Google Wallet API には、特にサポートされていないパスの作成に使用できる汎用パスタイプも用意されています。
ほとんどの場合、パスクラスとパス オブジェクトの両方を使用してパスが作成されます。
パス発行者
パス発行者は、パスを作成してユーザーに発行し、Google ウォレットに保存するためのエンティティです。パス発行者はパスを所有し、その作成、発行、更新を行うことができます。パス発行者には、個人のデベロッパー、企業、組織のほか、他人に代わってパスを作成、発行するアグリゲータ（イベント チケットや小売店向けクーポンの実装を専門とする企業など）も含まれます。
パスクラス
パスクラスは、パスの作成元となる共有テンプレートと考えることができます。パスクラスは、それを使用するすべてのパスに含まれる特定のプロパティを定義します。パス発行者は複数のクラスを作成し、スタイルや外観などの属性や、スマートタップ、登録とログインなどの追加機能を定義する独自のプロパティ セットをそれぞれ持つことができます。
ほとんどの場合、パスはパスのテンプレートを定義するパスクラスと、発行される個々のパスの詳細を定義するパス オブジェクトを指定することで作成されます。
パス オブジェクト
パス オブジェクトは、Google ウォレットに保存するためにユーザーに発行される個別のパスを定義します。多くの場合、パス オブジェクトにはユーザー固有の情報が含まれています。たとえば、パスクラスでは特定のショップのギフトカード パスの外観を定義できますが、パス オブジェクトは、残高や有効期限などの具体的な詳細を提供します。
多数のパス インスタンス間で共有できるパスクラスとは異なり、発行されるパスごとにパス オブジェクトを作成する必要があります。
プライベート パス
Google Wallet API を使用して作成する一部のパスには、ユーザーの機密情報が含まれることがあります。これらのパスは、ユーザーのデータを安全に保つために追加の保護を必要とし、Google Wallet API では汎用プライベート パスタイプを使用して別の方法で管理されます。汎用プライベート パスは、機密データ（Google Wallet API 利用規定で定義されている）がパスに含まれている場合に使用する必要があり、オンボーディング中に追加のプライバシー管理や審査の対象となる可能性があります。
スマートタップ
スマートタップは、モバイル デバイスと NFC 端末間でデータを転送するための Google 独自の近距離無線通信プロトコルです。スマートタップ テクノロジーを使用すると、ユーザーは、対応する NFC 端末にスマートフォンをかざすだけで、Google ウォレットに保存されているパスを利用できます。
パスでスマートタップ プロトコルを使用するには、スマートタップ対応端末のプロバイダとの関係を確立する必要があります。
API と SDK
Google Wallet API
Google Wallet API は Google が提供するサービスで、これを使用すると、ユーザーがパスを作成して発行し、ユーザーが Google ウォレットに保存できます。この API は、Google Wallet REST API、Google ウォレット Android SDK、Google ウォレット コンソールなど、さまざまな方法で使用できます。
Google ウォレット REST API
Google Wallet REST API は、Google Wallet API に HTTP リクエストを送信して、プログラムでパスを作成、管理するためのインターフェースです。
Google Wallet REST API を使用するには、Google Wallet REST API へのリクエストの認証に使用されるサービス アカウントを作成する Google Cloud アカウントも必要です。
Google ウォレット Android SDK
Google Wallet Android SDK には、パスの作成や発行など、Android アプリで Google Wallet API を使用するための一連の便利なメソッドが用意されています。
Google ウォレットに追加
[Google ウォレットに追加] ボタン
[Google ウォレットに追加] ボタンは、ユーザーにパスを提示するための Google 承認のアセットです。ユーザーがボタンをクリックまたはタップすると、[Google ウォレットに追加] リンクがトリガーされ、発行されたパスをユーザーの Google ウォレットに追加するフローが開始されます。
[Google ウォレットに追加] ボタンは、ユーザーがすでに操作方法を知っているなじみのある UI 要素であるため、可能な限り使用することをおすすめします。
ボタンを使用するためのアセットとガイドラインについては、Google Wallet API ブランド ガイドラインをご覧ください。
[Google ウォレットに追加] リンク
[Google ウォレットに追加] リンクを使用すると、通常のハイパーリンクでユーザーにパスを発行できます。リンクは、メール、SMS、ウェブサイト、モバイルアプリなど、ハイパーリンクを使用できる場所であればどこでも使用できます。
[Google ウォレットに追加] リンクは、署名付き JWT を URL https://pay.google.com/gp/v/save/ に追加することによって作成されます。
発行者アカウント
デモモード
発行者アカウントを作成すると、公開アクセスが承認されるまで「デモモード」になります。デモモードではパスを作成できますが、パスを発行できるのは、発行者アカウントの「管理者」または「デベロッパー」のロールを持つユーザー、または Google ウォレット コンソールでテスト アカウントとして追加されたユーザーのみです。
「デモモード」では、発行するパスのタイトルが自動的に「[テスト専用]」という単語で始まります。これは、パスがテスト専用であることを示します。
テスト アカウント
発行者アカウントが「デモモード」で、アカウントの「管理者」または「デベロッパー」のロールを持たないユーザーにパスを発行するには、Google ウォレット コンソールでテスト アカウントとして追加する必要があります。テスト アカウントとして登録したユーザーは、ニュース メディアが発行したパスを Google ウォレットに追加できます。これは、「デモモード」で幅広いユーザーにパスをテストする場合に便利です。
ビジネス プロフィール
Google Wallet API の発行者アカウントを作成するには、Google Pay & ウォレット コンソールに登録する際にビジネス プロフィールを設定する必要があります。ビジネス プロフィールは、お客様の会社や組織の基本情報を Google に提供するもので、公開アクセスの承認を受ける必要があります。
アクセスの公開
すべてのユーザーが Google ウォレットに保存できるパスを発行するには、その前に、公開アクセスの承認を受ける必要があります。公開アクセスの承認を受けるには、少なくとも 1 つのパスクラスを作成し、完全なビジネス プロフィールを取得している必要があります。Google ウォレット Android SDK を使用してパスを発行するカード発行会社は、アプリの SHA-1 フィンガープリントも送信する必要があります。
公開アクセスをリクエストするには、Google ウォレット コンソールに移動し、[公開アクセスをリクエスト] ボタンをクリックします。Google ウォレット チームがリクエストを審査し、公開アクセスの許可が完了しましたらお知らせいたします。
認証
JSON Web Token（JWT）
JSON Web Token は、情報を JSON オブジェクトとして安全に転送するために一般的に使用されている業界標準です。Google Wallet API を使用する場合は、使用するパス オブジェクトの詳細を JWT（「ジョット」と発音）形式でパス インスタンスを作成し、Google Wallet API へのリクエストでその JWT を送信します。
JWT は、Google Wallet API に送信される前に共有シークレットで署名することで保護されます。Google Wallet REST API を使用している場合、署名シークレットは Google Cloud サービス アカウント キーです。Google ウォレット Android SDK を使用している場合、署名シークレットは Android アプリの SHA-1 フィンガープリントです。
サービス アカウント
Google Cloud サービス アカウントは、ユーザーではなく通常、アプリケーションやコンピューティング ワークロードによって使用される特別なアカウントです。Google Wallet API の場合、サービス アカウントは、Google Wallet REST API に送信されるリクエストの認証に使用するアカウントです。
サービス アカウントは Google Cloud コンソールで作成されます。サービス アカウントを使用するには、Cloud コンソールで Google Wallet API を有効にして、サービス アカウントが Google Wallet REST API にリクエストを送信できるようにする必要もあります。
サービス アカウント キー
サービス アカウント キーは、Google Wallet REST API の呼び出しの認証に使用する認証情報です。サービス アカウント キーは、Google Wallet REST API を使用してアカウントのパス発行者機能（パスクラス オブジェクトやパス オブジェクトの作成など）の多くへのアクセス権を付与されるため、機密性が高いと見なされ、非公開にする必要があります。
SHA-1 フィンガープリント
Android アプリ署名証明書の SHA-1 フィンガープリントは、Google Wallet Android SDK を使用するときに Google Wallet API の呼び出しを認証するために使用する認証情報です。証明書の SHA-1 フィンガープリントは、Gradle または keytool を使用して生成されます。フィンガープリントを使用してリクエストを認証するには、このフィンガープリントを Google ウォレット コンソールに登録する必要があります。