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 针对实际数据调用此方法,然后查看响应。