Sintaxe da lista de instruções

Uma lista de instruções é um arquivo ou snippet codificado em JSON em um local conhecido.

Local da lista de extratos

Consulte Como criar uma lista de instruções para saber onde essa lista precisa ser armazenada.

Sintaxe

A lista de instruções ou snippet consiste em uma matriz JSON de uma ou mais instruções de site ou apps como objetos JSON. Essas instruções podem estar em qualquer ordem. Esta é a sintaxe geral:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]
relação
Uma matriz de uma ou mais strings que descrevem a relação declarada sobre o destino. Veja a lista de strings de relação definidas. Exemplo: delegate_permission/common.handle_all_urls
target
O recurso de destino a que esta instrução se aplica. Tipos de segmentação disponíveis:

Exemplo de lista de extratos

Veja um exemplo de lista de instruções de sites que contém declarações sobre sites e apps: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Escalonamento para dezenas de instruções ou mais

Em alguns casos, um principal pode querer fazer muitas instruções diferentes sobre destinos diferentes ou pode ser necessário emitir instruções de principais diferentes para o mesmo conjunto de destinos. Por exemplo, um site pode estar disponível em vários domínios de nível superior diferentes em cada país, e todos podem querer fazer uma declaração sobre o mesmo app para dispositivos móveis.

Nessas situações, as instruções de inclusão podem ser úteis. Com esse mecanismo, você pode configurar ponteiros de vários principais diferentes para um local central, que define as instruções para todos os principais.

Por exemplo, você pode decidir que o local central precisa ser "https://example.com/includedstatements.json". Esse arquivo pode ser configurado para incluir o mesmo conteúdo dos exemplos acima.

Para configurar um ponteiro de um site para o arquivo de inclusão, mude "https://example.com/.well-known/assetlinks.json" para:

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

Para configurar um ponteiro de um app Android para o arquivo de inclusão, mude "res/values/strings.xml" para:

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

Mais informações

Veja uma explicação mais detalhada sobre o formato da lista de instruções e os conceitos subjacentes no nosso documento de especificação.