ステートメントを使用する

すべてのステートメントはコンシューマーを念頭に置いて設計されています。ステートメント コンシューマーは、プリンシパルのステートメントを読み、検証し、そのステートメントに基づいてアクションを実行するユーザーです。具体的には、コンシューマは次の基本的なステップを実行します。

  1. 特定のプリンシパルのステートメント リストをリクエストする
  2. 指定されたターゲットに対する特定のステートメントがリストに含まれているかどうかを確認する
  3. ステートメント内のターゲットが、想定どおりのターゲット(ウェブサイトまたはアプリ)であることを確認します。
  4. ステートメントで指定されたアクションを実行する(選択した場合)

多くのユースケースでは、ステートメントがバックグラウンドで使用されます。たとえば、Android App Linking は、ウェブサイトが作成したリンクの許可ステートメントを使用して、アプリに直接リンクできるようにします。アプリは、マニフェストに特別なコード(インテント ハンドラ)を追加することで、そのようなステートメントのターゲットになることに同意していることを示します。

上記のステップ 1 と 2(ステートメントのリクエストと検証)は、API を使用する方法と手動(独自の実装を使用)の 2 つの方法で実行できます。

Digital Asset Links API を使用したステートメントの使用

Digital Asset Links API は、ステートメントを検索または検証する Check()List() の 2 つのメソッドをサポートしています。

  • Check() は、ソース、ターゲット、関係を受け取り、ソースがターゲットに関して送信されたステートメントを作成したことを確認します。
  • List() は、指定されたソースによって行われたすべてのステートメントを一覧表示します。

ステートメントを手動で使用する

デジタル アセット リンク プロトコルは公開されているので、自分で実装を作成できます。

ウェブサイトで作成されたステートメントを使用するには、対応するステートメント リストに対する HTTP GET リクエストを行い、ご自身で解析します。たとえば、ウェブサイト http://example.digitalassetlinks.org の対応するステートメント リストは http://example.digitalassetlinks.org/.well-known/assetlinks.json にあります。

Android アプリのステートメントを使用するには、対応する APK パッケージのマニフェストにアクセスする必要があります。Android デバイスでは、PackageManager インターフェースを使用してこれを実現できます。

デジタル アセット リンクに関するステートメントの具体的な意味には特に注意してください。不明な場合は、アセットリンクの仕様をご覧ください。