このページでは、スマートタップ プロトコルで使用される識別子について説明します。
概要
スマートタップ プロトコルは、ユーザーの Google ウォレット アプリと端末アプリケーションに保存されるパスに関する情報を伝達します。次の図に、端末と Google ウォレットの間の通信フローの概要を示します。
販売者は複数の企業や請負業者と契約してパスを開発する場合があるため、Google は、Google ウォレットと端末の間の情報送信を容易にするために、3 つの識別子を使用します。これにより、特定の端末プロバイダと契約している販売者は、さまざまなデベロッパーから提供されるパスを使用できます。次の ID は、スマートタップ プロトコルで使用される 3 つの「コレクション識別子」です。
クーポン発行者 ID
クーポン発行者 ID は特別なタイプの発行者 ID です。クーポン発行者 ID は通常、1 つの販売者を表します。それに対して、パスのデベロッパーの発行者 ID は、多くの異なる販売者のパスクラスが格納されるプラットフォームを表します。複数の販売者のパスクラスが格納されるプラットフォームは、アグリゲータとも呼ばれます。
クーポン発行者はスマートタップ以外でも使用されます。たとえば、クーポン発行者のロケーションに基づいて、位置情報を利用した通知を行う場合にも使用されます。そのため、パスでクーポン発行者として登録されている発行者 ID をスマートタップ用に構成できない場合があります。
クーポン発行者 ID と発行者 ID の比較
発行者 ID は、Google ウォレット発行者アカウントの一意の識別子で、Google Pay & ウォレット コンソールで確認できます。
発行者は、販売者（レストランなど）、クーポンの提供元、端末メーカーなどを表すことができます。パスのクラスとオブジェクトが作成されると、特定の発行者 ID にリンクされます。発行者 ID は、パスクラス ID とオブジェクト ID の両方に含まれています。
| ID | フォーマット | メモ |
|---|---|---|
| クラス ID | issuerId.classSuffix
|
classSuffix は、特定のパスクラス（ポイント階層など）に対してデベロッパーが定義した一意の値です。 |
| オブジェクト ID | issuerId.objectSuffix
|
objectSuffix は、特定のパス オブジェクト（ユーザー ID など）に対してデベロッパーが定義した一意の値です。 |
発行者は、必要な数だけクラスを作成できます。
コレクタ ID
販売者が端末でスマートタップをサポートしている場合、クーポン発行者にはコレクタ ID が割り当てられます。コレクタ ID は、端末で端末自体の識別情報として使用される数値 ID（8 桁）です。クーポン発行者は複数の販売者をサポートする場合があるため、特定の販売者のパスをリクエストするにはコレクタ ID を使用します。
ユーザーがスマートタップ対応端末にデバイスをタップすると、端末からユーザーのデバイスにコレクタ ID が送信されます。続いて、デバイスは、そのコレクタ ID の公開鍵を使用して端末で認証を行います。詳細については、通信フローをご覧ください。
注意事項:
- 1 つの発行者 ID に対して 1 つのコレクタ ID のみが割り当てられます
- コレクタ ID は、すべての発行者 ID の中で一意になります
発行者 ID に対応するコレクタ ID を取得するには、販売者の構成をご覧ください。
パスクラス ID
クラス ID は、パスの特定の階層またはタイプを識別します。クラス ID の形式は次のとおりです。
issuerId.classSuffix
クラスの接尾辞は、このパスクラスに固有である、デベロッパーが定義した値です。このクラス ID を参照するパス オブジェクトは、ユーザーの Google ウォレット アプリに保存されます。