Una lista de declaraciones es un archivo o fragmento codificados en JSON en una ubicación conocida.
Ubicación de la lista de estados de cuenta
Consulta Cómo crear una lista de instrucciones para saber dónde debe almacenarse esta lista.
Sintaxis
La lista o el fragmento de instrucciones consta de un array JSON de una o más declaraciones de sitios web o apps como objetos JSON. Estas declaraciones pueden estar en cualquier orden. Esta es la sintaxis general:
[ { "relation": ["relation_string"], "target": {target_object} } , ... ]
- relation
- Es un array de una o más cadenas que describen la relación que se declara sobre el objetivo. Consulta la lista de cadenas de relación definidas. Ejemplo:
delegate_permission/common.handle_all_urls
- destino
- El recurso objetivo al que se aplica esta sentencia. Tipos de destinos disponibles:
Lista de declaraciones de ejemplo
A continuación, se incluye un ejemplo de una lista de declaraciones 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, una principal podría querer hacer muchas declaraciones diferentes sobre diferentes objetivos o puede ser 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 pueden querer realizar una declaración sobre la misma app para dispositivos móviles.
En estas situaciones, incluir sentencias puede ser útil. Con este mecanismo, puedes configurar punteros de muchos principales diferentes en una ubicación central, que define sentencias para todos los principales.
Por ejemplo, puedes decidir que la ubicación central sea “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 de un sitio web al 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 al 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
Encontrarás una explicación más detallada del formato de la lista de instrucciones y los conceptos subyacentes en nuestro documento de especificaciones.