Una lista de instrucciones es un archivo o fragmento codificado en JSON en una ubicación conocida.
Ubicación de la lista de resúmenes
Consulte Cómo crear una lista de instrucciones para obtener información sobre dónde debe almacenarse.
Sintaxis
La lista o el fragmento de la declaración consiste en un arreglo JSON de una o más declaraciones del sitio web o la app como objetos JSON. Estas declaraciones pueden estar en cualquier orden. Esta es la sintaxis general:
[ { "relation": ["relation_string"], "target": {target_object} } , ... ]
- relación
- Es un array de una o más strings que describe la relación que se declara sobre el destino. Consulta la lista de strings de relación definidas. Ejemplo:
delegate_permission/common.handle_all_urls
- target
- Es el elemento de destino al que se aplica esta afirmación. Tipos de orientaciones disponibles:
Ejemplo de lista de instrucciones
Aquí hay un ejemplo de lista de instrucciones de sitios web que contiene declaraciones sobre sitios web y apps: http://example.digitalassetlinks.org/.well-known/assetlinks.json
Escalamiento a decenas de declaraciones o más
En algunos casos, es posible que una principal quiera hacer muchas declaraciones diferentes sobre diferentes objetivos, o que sea necesario emitir declaraciones de diferentes principales al mismo conjunto de objetivos. Por ejemplo, un sitio web puede estar disponible en muchos dominios de nivel superior diferentes por país, y todos ellos quieren hacer una declaración sobre la misma aplicación para dispositivos móviles.
Para estas situaciones, incluir declaraciones puede ser útil. Con este mecanismo, puedes configurar punteros desde varias principales diferentes para una ubicación central, lo que define instrucciones para todas las principales.
Por ejemplo, puedes decidir que la ubicación central debe ser `https://example.com/includedstatements.json`. Este archivo se puede configurar para que incluya el mismo contenido que en los ejemplos anteriores.
Para configurar un puntero desde un sitio web hasta el archivo de inclusión, cambia `https://example.com/.well-known/assetlinks.json` a lo siguiente:
[{ "include": "https://example.com/includedstatements.json" }]
Para configurar un puntero desde una app para Android hasta el archivo de inclusión, cambia `res/values/strings.xml` a lo siguiente:
<resources> ... <string name="asset_statements"> [{ \"include\": \"https://example.com/includedstatements.json\" }] </string> </resources>
Más información
Puedes encontrar una explicación más detallada del formato de la lista de instrucciones y de los conceptos subyacentes en nuestro documento de especificación.