すべてのステートメントは消費者を念頭に置いて設計されています。ステートメント コンシューマは、プリンシパルが作成したステートメントを読み取って検証し、そのステートメントに基づいてアクションを実行します。具体的には、コンシューマは以下の基本的な手順を行います。
- 特定のプリンシパルにステートメント リストをリクエストする
- リストに、特定のターゲットに対する特定のステートメントが含まれているかどうかを確認します
- ステートメント内のターゲットが、ターゲット(ウェブサイトまたはアプリ)であることを確認します。
- 指定した場合は、ステートメントで指定されたアクションを実行します。
多くのユースケースでは、バックグラウンドで API を使用します。たとえば、Android アプリリンクは、ウェブサイトが作成したリンク権限ステートメントを使用して、リンクを直接アプリで使用できるようにします。アプリは、マニフェストに特別なコード(インテント ハンドラ)を追加することで、そのようなステートメントのターゲットになることに同意します。
上のステップ 1 と 2 は、Google の API を使用して行うか、独自の実装を使用して手動で行う(ステートメントをリクエストして検証する)方法です。
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 インターフェースを使用してこの処理を行います。
デジタル アセット リンクの文言の具体的な意味に特に注意してください。不明な場合は、アセットリンクの仕様を参照してください。