Esta página foi traduzida pela API Cloud Translation.

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 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:

Destino do site
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
namespace

Precisa ser web para sites.

site

O URI do site que é o destino da instrução, no formato http[s]://<hostname>[:<port>], em que <hostname> é totalmente qualificado, e <port> precisa ser omitido ao usar a porta 80 para HTTP ou a porta 443 para HTTPS. Um destino de site só pode ser um domínio raiz; não é possível limitar a um subdiretório específico; todos os diretórios sob essa raiz serão correspondentes. Os subdomínios não devem ser considerados correspondentes: ou seja, se o arquivo de instrução estiver hospedado em www.example.com, www.puppies.example.com não deverá ser considerado uma correspondência. Para conferir regras e exemplos sobre a correspondência de destinos de site, consulte a documentação sobre destinos. Exemplo: http://www.example.com
Destino do app Android
```
"target": {
  "namespace": "android_app",
  "package_name": "fully_qualified_package_name",
  "sha256_cert_fingerprints": ["cert_fingerprint"]
}
```
namespace

Precisa ser android_app para apps Android.

package_name

O nome do pacote totalmente qualificado do app a que essa declaração se aplica. Exemplo: com.google.android.apps.maps

sha256_cert_fingerprints
A impressão digital SHA265 em letras maiúsculas do certificado do app a que esta instrução se aplica. Calcule isso usando openssl ou keytool do Java, conforme mostrado aqui:
- openssl x509 -in $CERTFILE -noout -fingerprint -sha256
- keytool -printcert -file $CERTFILE | grep SHA256
Exemplo:["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"].
Se você estiver usando a Assinatura de apps do Google Play no seu app, a impressão digital do certificado gerada pela execução local de keytool ou openssl geralmente não corresponde àquela nos dispositivos dos usuários. Você pode verificar se está usando a Assinatura de apps do Google Play para seu app na conta de desenvolvedor do Play Console em Release > Setup > App Integrity. Se fizer isso, você também vai encontrar o snippet JSON correto do Digital Asset Links do app na mesma página.

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.