Un elenco di istruzioni è un file o uno snippet codificato in JSON in una posizione nota.
Posizione elenco estratti conto
Consulta la sezione Creazione di un elenco di istruzioni per sapere dove deve essere archiviato questo elenco.
Sintassi
L'elenco di istruzioni o lo snippet è costituito da un array JSON di una o più istruzioni di siti web o app come oggetti JSON. Queste istruzioni possono essere ordinate in qualsiasi ordine. Ecco la sintassi generale:
[ { "relation": ["relation_string"], "target": {target_object} } , ... ]
- relation
- Un array di una o più stringhe che descrivono la relazione dichiarata riguardo alla destinazione. Consulta l'elenco di stringhe di relazione definite. Esempio:
delegate_permission/common.handle_all_urls
- target
- L'asset target a cui si applica la presente dichiarazione. Tipi di target disponibili:
Elenco di istruzioni di esempio
Ecco un esempio di elenco di istruzioni per il sito web che contiene dichiarazioni riguardanti siti web e app: http://example.digitalassetlinks.org/.well-known/assetlinks.json
Scalare fino a decine di dichiarazioni o più
In alcuni casi, un'entità potrebbe voler fare molte istruzioni diverse su target diversi oppure potrebbe essere necessario emettere istruzioni da entità diverse allo stesso insieme di destinazioni. Ad esempio, un sito web potrebbe essere disponibile su più domini di primo livello per paese e tutti potrebbero voler fare un'affermazione sulla stessa app mobile.
In questi casi, le istruzioni di inclusione possono essere utili. Utilizzando questo meccanismo, puoi impostare i puntatori da molte entità diverse a un'unica posizione centrale, che definisce le istruzioni per tutte le entità.
Ad esempio, potresti decidere che la posizione centrale deve essere "https://example.com/includedstatements.json". Questo file può essere configurato in modo da includere gli stessi contenuti degli esempi precedenti.
Per impostare un puntatore da un sito web al file di inclusione, modifica "https://example.com/.well-known/assetlinks.json" in:
[{ "include": "https://example.com/includedstatements.json" }]
Per configurare un puntatore da un'app per Android al file di inclusione, modifica "res/values/strings.xml" in:
<resources> ... <string name="asset_statements"> [{ \"include\": \"https://example.com/includedstatements.json\" }] </string> </resources>
Ulteriori informazioni
Una spiegazione più dettagliata del formato dell'elenco di dichiarazioni e dei concetti alla base è disponibile nel nostro documento delle specifiche.