Se usó la API de Cloud Translation para traducir esta página.

Sintaxis de la lista de instrucciones

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:

Orientación del sitio web
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
espacio de nombres

Debe ser web para los sitios web.

sitio

El URI del sitio objetivo de la sentencia, en el formato http[s]://<hostname>[:<port>], en el que <hostname> está completamente calificado y <port> debe omitirse cuando se usa el puerto 80 para HTTP o el puerto 443 para HTTPS. El destino de un sitio web solo puede ser un dominio raíz. No se puede limitar a un subdirectorio específico; todos los directorios de esta raíz coincidirán. No se debe considerar que los subdominios coinciden, es decir, si el archivo de instrucción está alojado en www.example.com, entonces www.cachorros.example.com no debe considerarse una coincidencia. Para ver las reglas y ejemplos sobre la coincidencia de objetivos del sitio web, consulta la documentación sobre objetivos. Ejemplo: http://www.example.com
Objetivo de la app para Android
```
"target": {
  "namespace": "android_app",
  "package_name": "fully_qualified_package_name",
  "sha256_cert_fingerprints": ["cert_fingerprint"]
}
```
espacio de nombres

Debe ser android_app para las apps para Android.

package_name

Es el nombre completo del paquete de la app a la que se aplica esta declaración. Ejemplo: com.google.android.apps.maps

sha256_cert_fingerprints
La huella digital SHA265 en mayúscula del certificado para la app a la que se aplica esta declaración. Puedes calcular esto con openssl o Java keytool como se muestra a continuación:
- openssl x509 -in $CERTFILE -noout -fingerprint -sha256
- keytool -printcert -file $CERTFILE | grep SHA256
Ejemplo: ["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"].
Si usas la firma de apps de Play para tu app, por lo general, la huella digital del certificado que se produce cuando se ejecuta keytool o openssl de forma local no coincide con la de los dispositivos de los usuarios. Puedes verificar si usas la firma de apps de Play para tu app en tu cuenta de desarrollador de Play Console en Release > Setup > App Integrity. Si lo haces, también encontrarás el fragmento JSON de Vínculos de recursos digitales correcto para tu app en la misma página.

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.