语句列表语法

语句列表是位于某个知名位置的 JSON 编码文件或代码段。

对账单列表的位置

如需了解应将此列表存储在何处,请参阅创建语句列表

语法

声明列表或代码段由一个 JSON 数组组成,其中包含一个或多个网站或应用声明(以 JSON 对象的形式)。这些语句可以按任意顺序排列。一般语法如下:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]
关系
由一个或多个字符串组成的数组,用于描述所声明的关于目标的关系。请参阅已定义的关系字符串列表。示例delegate_permission/common.handle_all_urls
目标
此语句适用的目标资产。可用的目标类型: <ph type="x-smartling-placeholder">
    </ph>

语句列表示例

下面是一个网站语句列表示例,其中包含有关网站和应用的语句:http://example.digitalassetlinks.org/.well-known/assetlinks.json

扩展到数十个或更多语句

在某些情况下,主账号可能希望创建许多不同的语句 或者需要就不同的目标发表声明, 向同一组目标分配不同的主账号。例如,某个网站可能在许多不同的国家/地区顶级域名上提供,并且所有这些域名都可能需要针对同一款移动应用做出声明。

对于这些情况,include 语句会很有帮助。 使用此机制,您可以设置来自许多不同主账号的指针 一个中心位置,用于定义所有主账号的语句。

例如,您可以决定中央位置应为 `https://example.com/includedstatements.json`。此文件可以配置为包含与上述示例相同的内容。

如需从网站设置指向包含文件的指针,请将 `https://example.com/.well-known/assetlinks.json` 更改为:

[{
  "include": "https://example.com/includedstatements.json"
}]

设置从 Android 应用指向包含内容的指针 请将 `res/values/strings.xml` 更改为:

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

更多信息

如需详细了解语句列表格式和底层概念,请参阅我们的规范文档