ステートメントの使用

すべてのステートメントは消費者を念頭に置いて設計されています。ステートメント コンシューマは、プリンシパルが作成したステートメントを読み取って検証し、そのステートメントに基づいてアクションを実行します。具体的には、コンシューマは以下の基本的な手順を行います。

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

多くのユースケースでは、バックグラウンドで 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 インターフェースを使用してこの処理を行います。

デジタル アセット リンクの文言の具体的な意味に特に注意してください。不明な場合は、アセットリンクの仕様を参照してください。