Method assetlinks.check

确定指定的源资源和目标资源之间是否存在指定的（方向）关系。

这种关系描述了源资产对两项资产建立关联的意图。例如，特权或权限的委托就属于此类关系。

基础架构系统最常使用此命令来检查某项操作的前提条件。例如，客户端可能想要了解是否可以改为将网址发送到特定的移动应用。客户可以查看从网站指向移动应用的相关素材资源链接，以决定是否允许此操作。

有关安全性的注意事项：如果您指定一种安全资产（例如 HTTPS 网站或 Android 应用）作为来源，该 API 将确保用于生成响应的所有语句都由该资产的所有者通过安全的方式做出。反之，如果源资源是一个不安全的 HTTP 网站（即网址以 http:// 而不是 https:// 开头），则 API 将无法安全地验证其语句，也无法保证第三方更改了网站的语句。如需了解详情，请参阅 Digital Asset Links 技术设计规范。

HTTP 请求

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

查询参数

参数名称 类型 说明
source object(Asset) 托管语句列表的来源。这用于将 Check() 调用路由到正确的来源。
relation string

关系的查询字符串。

我们使用 <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

自投放时间起，除非进一步更新，否则响应在多长时间内被视为有效。必填

该持续时间以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。
debugString string

人类可读的消息，其中包含旨在帮助最终用户理解、重现和调试结果的信息。

该消息将采用英语，我们目前不打算提供任何翻译。

请注意，我们不对此字符串的内容或格式做出任何保证。条款的任何方面都可能会发生更改，恕不另行通知。您不应尝试以程序化方式解析此数据。如果您觉得需要这样做是因为 API 没有以其他方式提供您所需的信息，请首先与我们联系。

试试看！

使用 API Explorer 针对实际数据调用此方法并查看响应。