Uma lista de instruções é um arquivo ou snippet codificado em JSON em um local conhecido.
Local da lista de declarações
Consulte Como criar uma lista de instruções para saber onde essa lista deve ser armazenada.
Sintaxe
A lista ou o snippet de instruções consiste em uma matriz JSON de uma ou mais instruções do site ou app como objetos JSON. Essas declarações podem estar em qualquer ordem. Esta é a sintaxe geral:
[ { "relation": ["relation_string"], "target": {target_object} } , ... ]
- relation
- Uma matriz de uma ou mais strings que descrevem a relação que está sendo declarada sobre o destino. Confira a lista de strings de relação definidas. Exemplo:
delegate_permission/common.handle_all_urls
- destino
- O recurso de destino a que esta instrução se aplica. Tipos de segmentação disponíveis:
Lista de instruções de exemplo
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 declarações diferentes sobre diferentes destinos ou pode haver a necessidade de emitir instruções de principais diferentes para o mesmo conjunto de destinos. Por exemplo, um site pode estar disponível em muitos domínios de nível superior diferentes por país, e todos eles podem querer fazer uma declaração sobre o mesmo app para dispositivos móveis.
Nessas situações, instruções "include" podem ser úteis. Com esse mecanismo, é possível configurar ponteiros de várias principais diferentes para uma localização central, que define instruções para todas elas.
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
Há uma explicação mais detalhada sobre o formato da lista de instruções e os conceitos relacionados no nosso documento de especificações.