このページでは、スマートタップ プロトコルで使用される識別子について説明します。
概要
スマートタップ プロトコルは、ユーザーの Google ウォレット アプリと端末アプリに保存されたパスに関する情報を伝達します。次の図は、端末と Google ウォレット間の通信フローの概要を示しています。
販売者はパスの開発に複数の企業や請負業者を利用する可能性があるため、Google では 3 つの識別子を使用して Google ウォレットと端末間での情報送信を容易にしています。これにより、特定の端末プロバイダと契約している販売者は、さまざまなデベロッパーから提供されるパスを利用できます。次の ID は、スマートタップ プロトコルで使用される 3 つの「コレクション識別子」です。
クーポン発行者 ID
クーポン発行者 ID は特定の種類の発行者 ID です。クーポン発行者 ID は通常、1 つの販売者を表します。一方、パスのデベロッパーの発行者 ID は、さまざまな販売者のパスクラスが格納されるプラットフォームを表します。複数の販売者のパスクラスが格納されるプラットフォームは、アグリゲータとも呼ばれます。
クーポン発行者はスマートタップ以外でも使用されます。たとえば、クーポン発行者のロケーションに基づいて、位置情報を利用した通知を行う場合にも使用されます。そのため、パスでクーポン発行者としてリストされている発行者 ID が、スマートタップ用に構成されていない可能性があります。
クーポン発行者 ID と発行者 ID の比較
発行者 ID は、Google ウォレット発行者アカウントの一意の識別子です。発行者 ID は 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 に割り当てられるコレクタ ID は 1 つのみです
- コレクタ ID は、すべての発行者 ID の中で一意です
発行者 ID のコレクタ ID を取得するには、販売者の構成をご覧ください。
パスクラス ID
クラス ID は、パスの特定の階層またはタイプを識別します。クラス ID の形式は次のとおりです。
issuerId.classSuffix
クラス サフィックスは、このパスクラスに固有の、デベロッパーが定義する値です。このクラス ID を参照するパス オブジェクトは、ユーザーの Google ウォレット アプリに保存されます。