Method assetlinks.check

指定したソース アセットとターゲット アセットの間に、指定された（方向の）関係が存在するかどうかを判別します。

関係は、ソースアセットによって申し立てられている 2 つのアセット間のリンクの意図を表します。このような関係の例として、権限や権限の委任があります。

このコマンドは、インフラストラクチャ システムがアクションの前提条件を確認する際によく使用されます。たとえば、クライアントは、ウェブ URL を特定のモバイルアプリに送信しても問題ないかどうかを知りたい場合があります。クライアントはウェブサイトからモバイルアプリへの関連アセットリンクを確認して、この処理を許可するかどうかを判断できます。

セキュリティに関する注意: HTTPS ウェブサイトや Android アプリなど、安全なアセットをソースとして指定すると、API により、レスポンスの生成に使用されるステートメントが、そのアセットの所有者によって安全な方法で行われたことが確認されます。逆に、ソースアセットが安全でない HTTP ウェブサイト（URL が https:// ではなく http:// で始まる場合）の場合、API はそのステートメントを安全に検証できず、ウェブサイトのステートメントが第三者によって変更されていないことを保証できません。詳しくは、デジタル アセット リンクの技術設計仕様をご覧ください。

HTTP リクエスト

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

クエリ パラメータ

パラメータ名 タイプ 説明
source object(Asset) ステートメント リストをホストするソース。これは、Check() 呼び出しを適切なソースにルーティングするために使用されます。
relation string

リレーションのクエリ文字列。

リレーションは <kind>/<detail> という形式の文字列で識別されます。ここで、<kind> は定義済みの目的カテゴリのセットのいずれかである必要があります。<detail> は、ステートメントの特定のユースケースを表す自由形式の小文字の英数字の文字列です。

サポートされているリレーションの最新リストについては、Google の API ドキュメントをご覧ください。

クエリがアセットリンクと一致するには、クエリとアセットリンクのリレーション文字列の両方が正確に一致する必要があります。

例: リレーションが delegate_permission/common.handle_all_urls のクエリは、リレーションが delegate_permission/common.handle_all_urls のアセットリンクと一致します。
target object(Asset) ステートメントのターゲット アセット。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

CheckAssetLinks 呼び出しに対するレスポンス メッセージ。

JSON 表現 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
フィールド名 タイプ 説明
linked boolean リクエストで指定されたアセットが、リクエストで指定されたリレーションによってリンクされている場合は true に設定します。REQUIRED
maxAge string

サービング時刻から、更新を行わない限り、レスポンスが有効とみなされるまでの時間。REQUIRED

小数点以下 9 桁まで、「s」で終わる秒単位の期間（例: "3.5s"）。
debugString string

エンドユーザーが結果を理解、再現、デバッグするのに役立つ情報を含む、人が読める形式のメッセージ。

メッセージは英語で表示され、現時点では翻訳の提供は予定しておりません。

この文字列の内容や形式が保証されるわけではありません。本コンテンツのあらゆる側面は、予告なく変更される場合があります。このデータをプログラムで解析しないでください。必要な情報が API によって公開されないために、この操作が必要だと思われる場合は、まず Google までご連絡ください。

試してみよう:

API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。