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

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

Google では、<kind>/<detail> という形式の文字列とのリレーションを特定します。<kind> は事前定義済みの目的のカテゴリセットの一つで、<detail> はステートメントの特定のユースケースを説明する自由形式の小文字の英数字の文字列です。

現在サポートされているリレーションについては、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 に設定します。必須かどうか
maxAge string

配信から、さらに有効な更新がない場合にレスポンスが有効な期間としてみなされます。必須かどうか

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

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

このメッセージは英語で送信されます。翻訳は提供されません。

この文字列の内容や形式について、保証するものではありません。予告なく変更される場合があります。このデータをプログラムで解析しないでください。必要な情報が API によって公開されていないためにこの手続きが必要であると思われる場合は、まず Google までお問い合わせください。

実習

API Explorer を使用してライブデータでこのメソッドを呼び出し、レスポンスを確認します。