TL;DR
- GS1 Digital Linkリゾルバは、GS1 Digital Linkのドメインの背後にあるウェブサービスです。スキャンされたアドレス内の識別子を読み取り、読み手を適切な行き先へ送ります。製品ページ、回収告知、取扱説明書、または機械可読なデータです。
- リゾルバが応じるリクエストは3種類あります。通常のスキャンは既定のリンクへ、特定のリンクタイプの要求はそのリンクへ送られ、リンクセットの要求に対しては、その製品について保持するすべてのリンクを返します。
- リゾルバは、ブランド、GS1加盟組織、小売業者、ソリューション提供事業者が運用できます。それぞれが独立しており、同じGS1標準に従っているため、準拠したアプリならどのリゾルバでも利用できます。
GS1 Digital Linkリゾルバは、製品のGTINなどのGS1識別子を、それに関するオンライン上の情報に結び付けるウェブサーバーです。スマートフォンがGS1 Digital LinkのQRコードをスキャンすると、リクエストはコードのドメインにあるリゾルバに届きます。リゾルバはアドレスを確認し、その製品、ロット、または個品について保存されているリンクを見つけ、リクエストに合うものへリダイレクトします。これにより、1つのコードが買い物客、取引先、システムのそれぞれに、異なるものを届けられます。
リゾルバの概要
| 何か | GS1識別子をオンライン上のリソースへ解決するウェブサーバー |
| 入力 | GS1 Digital Link URI：ドメイン、主キー、修飾子、属性 |
| 出力 | 行き先へのリダイレクト、リンクの一覧、または行き先がない理由を説明するエラー |
| 誰が運用するか | ブランド、GS1加盟組織、小売業者、ソリューション提供事業者 |
| 標準 | 準拠リゾルバに関するGS1の仕様。GS1 Digital Link URIの構文と併せて定められています |
| プロトコル | HTTPS。GET、HEAD、OPTIONSのリクエストに応答し、ウェブアプリから問い合わせられるようCORSに対応 |
リゾルバへの3つの問い合わせ方法
| リクエスト | リゾルバの動作 | 主な読み手 |
|---|---|---|
| アドレスの通常のスキャン | 既定のリンク（通常は製品ページ）へリダイレクトする | 買い物客のスマートフォン |
?linkType=gs1:recallStatus のような linkType パラメーター付きのアドレス | そのタイプのリンクがあれば、そこへリダイレクトする | 特定の情報を探しているアプリや取引先 |
linkType=linkset 付きのアドレス | その識別子について保持するリンクの一覧全体を、機械可読な形式で返す | 利用可能なすべての情報を把握したいシステムやアプリ |
リンクは、言語やコンテキストによって選ぶこともできます。同じコードから、フランスの買い物客をフランス語のページへ、ドイツの買い物客をドイツ語のページへ送ることができます。
リゾルバが各リクエストに対して行うこと
- 展開する。 小さなシンボル向けに標準が認めている圧縮形式がコードに含まれている場合、アドレスを展開します。
- 検証する。 構文を確認します。有効なGS1主キーであること、キー修飾子が正しい順序で並んでいること、データ属性が有効であることです。
- 検索する。 その識別子について保存されているリンクを、保持している最も詳細な単位（個品、ロット、または製品）で探します。
- 選択する。 リクエストに合うリンクを選びます。既定のリンク、要求されたリンクタイプ、またはリンクセットです。
- 応答する。 リダイレクト、リンクの一覧、または説明付きのエラーを返します。
各リンクに保存されるメタデータ
| 属性 | 必須 | 例 |
|---|---|---|
| ターゲットURL | はい | その製品に関するページのアドレス。ホームページや検索結果は不可 |
| リンクタイプ | はい | 製品情報ページ、gs1:pip |
| タイトル | はい | 「製品情報」。アプリが選択肢を一覧表示するときに表示されます |
| 言語 | いいえ | en、fr、de |
| メディアタイプ | いいえ | ページなら text/html、データなら application/json |
| コンテキスト | いいえ | 市場ごとの振り分けに使う地域や用途 |
1つのページが複数の役割を果たす場合、たとえばアレルゲン情報も表示する製品ページのように、1つのターゲットに複数のリンクタイプを付けることができます。
リゾルバの応答
| 状況 | 応答 |
|---|---|
| 一致するリンクがある | そこへのリダイレクト（307 Temporary Redirect）。HTTPの Link ヘッダーでリンクセットを提示します |
| リゾルバには情報がないが、別のリゾルバにはある可能性がある | 代替のリゾルバへのリダイレクト（307） |
| リゾルバに情報がない | 404 Not Found |
| リゾルバが、その識別子に応答できない理由を把握している | 説明を指し示す303 See Other |
| アドレスの形式が正しくない | 何が誤っているかを示すエラー応答 |
有効期限など、元のアドレスに含まれるクエリ文字列の値は、リゾルバがリダイレクトするときにそのまま引き継がれます。リダイレクトが1回増えるごとにスキャンする人の待ち時間が増えるため、リゾルバの連鎖は短く保つべきです。
GS1 Digital Linkリゾルバを設定する5つのステップ
- ドメインを選ぶ。
id.yourbrand.comのような自社のサブドメインを使えば、どの事業者がリゾルバを運用していてもコードは自社のものであり続け、アドレスで買い物客に自社ブランドを示せます。 - 自社で構築するか、提供事業者を利用する。 十分な時間と技術力があれば、誰でも準拠したリゾルバを構築できます。提供事業者を利用すれば、すぐに使えるリゾルバが手に入ります。いずれの場合も、準拠したあらゆるアプリが自社のコードを読めるよう、GS1のリゾルバ標準に従っていることを確認してください。
- 製品と既定のリンクを登録する。 各GTINを既定の行き先とともに追加します。回収時など、異なる行き先が必要な場合は、ロット単位または個品単位のエントリも追加します。
- リンクタイプ、言語、コンテキストを追加する。 各リンクにタイプとタイトルを付け、言語別バージョンを追加し、内容が異なる場合は市場ごとに振り分けます。
- すべての経路をテストする。 通常のスキャン、各リンクタイプの要求、リンクセット、未登録のGTIN、形式の誤ったアドレスを確認し、公開後はスキャンを監視します。コードが開かないときに確認すべきことは、トラブルシューティングのガイドで説明しています。
Digital Linkプラットフォームのリゾルバ
本サイトを運営するプラットフォームであるDigital Linkは、自社のコードのためにGS1準拠のリゾルバを運用します。プラットフォーム自身のドメインでも、CNAMEレコードを通じた自社のサブドメインでも利用できます。各製品には既定の行き先が設定され、言語別・国別のバージョンや、ロット・個品ごとのバリエーションも持てます。すべてのリンクは、再印刷せずにいつでも変更できます。
最初のGS1 Digital Link QRコードを作成する
よくある質問
GS1 Digital Linkリゾルバとは何ですか？
GS1 Digital Linkのドメインの背後にあるウェブサービスです。スキャンされたアドレス内の識別子を読み取り、その製品、ロット、または個品について保存されているリンクを見つけ、リクエストに合う行き先へリダイレクトします。
GS1 Digital Linkリゾルバは誰が運用していますか？
ブランド、GS1加盟組織、小売業者、ソリューション提供事業者のいずれも運用できます。それぞれは独立していますが、同じGS1標準に従っているため、アプリはどのリゾルバにも問い合わせられます。
リンクタイプとは何ですか？
リゾルバが製品について提供できる行き先の分類です。製品情報ページ（gs1:pip）や回収状況（gs1:recallStatus）などがあります。アプリは、既定のページではなく特定のリソースを得るためにリンクタイプを要求します。
リンクセットとは何ですか？
リゾルバがある識別子について保持するリンクの一覧全体で、アプリが linkType=linkset を要求したときに機械可読な形式で返されます。これにより、システムは製品について利用可能なすべての情報を把握できます。
自社のリゾルバが必要ですか？
コードの背後には準拠したリゾルバが必要ですが、自社で構築したものである必要はありません。大半のブランドは提供事業者を利用し、コードを自社のサブドメインに置くことで、コードを自社のものとして保っています。
レジはリゾルバを使いますか？
いいえ。2D対応のレジは、インターネットを使わずに、コードから直接GTIN、ロット、有効期限を読み取ります。リゾルバにアクセスするのは、アドレスを開くスマートフォンとアプリだけです。
