Syntaxe de la liste d'instructions

Une liste d'instructions est un fichier ou un extrait encodé en JSON à un emplacement connu.

Emplacement de la liste des relevés

Consultez la section Créer une liste de relevés pour savoir où cette liste doit être stockée.

Syntaxe

La liste ou l'extrait d'instructions se compose d'un tableau JSON d'une ou plusieurs instructions de site Web ou d'application en tant qu'objets JSON. Ces relevés peuvent être dans n'importe quel ordre. Voici la syntaxe générale:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]
relation
Tableau d'une ou plusieurs chaînes décrivant la relation déclarée concernant la cible. Consultez la liste des chaînes de relation définies. Exemple:delegate_permission/common.handle_all_urls
target
Asset cible auquel cette déclaration s'applique. Types de cibles disponibles :

Exemple de liste de relevés

Voici un exemple de liste d'instructions de site Web contenant des déclarations à la fois sur des sites Web et des applications: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Scaling vers des dizaines d'instructions ou plus

Dans certains cas, un principal peut vouloir faire de nombreuses instructions différentes sur différentes cibles ou il peut être nécessaire d'émettre des instructions de différents comptes principaux vers le même ensemble de cibles. Par exemple, un site Web peut être disponible sur de nombreux domaines de premier niveau par pays, et tous peuvent vouloir émettre une déclaration concernant la même application mobile.

Dans ce cas, les instructions d'inclusion peuvent être utiles. À l'aide de ce mécanisme, vous pouvez configurer les pointeurs de nombreux comptes principaux différents vers un emplacement central, qui définit les instructions pour tous les comptes principaux.

Par exemple, vous pouvez décider que l'emplacement central doit être "https://example.com/includedstatements.json". Ce fichier peut être configuré pour inclure le même contenu que dans les exemples ci-dessus.

Pour configurer un pointeur d'un site Web sur le fichier d'inclusion, remplacez "https://example.com/.well-known/assetlinks.json" par:

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

Pour configurer un pointeur d'une application Android sur le fichier d'inclusion, remplacez "res/values/strings.xml" par:

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

Plus d'infos

Vous trouverez une explication plus détaillée sur le format des listes d'instructions et les concepts sous-jacents dans notre document de spécifications.