すべてのステートメントはコンシューマーを念頭に置いて設計されています。ステートメント コンシューマーは、プリンシパルのステートメントを読み、検証し、そのステートメントに基づいてアクションを実行するユーザーです。具体的には、コンシューマは次の基本的なステップを実行します。
- 特定のプリンシパルのステートメント リストをリクエストする
- 指定されたターゲットに対する特定のステートメントがリストに含まれているかどうかを確認する
- ステートメント内のターゲットが、想定どおりのターゲット(ウェブサイトまたはアプリ)であることを確認します。
- ステートメントで指定されたアクションを実行する(選択した場合)
多くのユースケースでは、ステートメントがバックグラウンドで使用されます。たとえば、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 インターフェースを使用してこれを実現できます。
デジタル アセット リンクに関するステートメントの具体的な意味には特に注意してください。不明な場合は、アセットリンクの仕様をご覧ください。