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

Sintaxis de la lista de instrucciones

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:

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

Debe ser web para los sitios web.

sitio

El URI del sitio que es el destino de la declaración, en el formato http[s]://<hostname>[:<port>], en el que <hostname> está completamente calificado y se debe omitir <port> cuando se usa el puerto 80 para HTTP o el puerto 443 para HTTPS. Una orientación de 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. Los subdominios no deben considerarse coincidencias, es decir, si el archivo de declaración está alojado en www.example.com, www.puppies.example.com no debe considerarse una coincidencia. Para ver las reglas y los ejemplos sobre la coincidencia de orientaciones de sitios web, consulte la documentación sobre objetivos. Ejemplo: http://www.example.com
Orientación de aplicación 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 de Android.

package_name [nombre_paquete]

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

huellas_sha256_certificados
Es la huella digital SHA265 en mayúsculas del certificado de la app a la que se aplica esta declaración. Puedes calcular esto con openssl o keytool de Java como se muestra aquí:
- 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 al ejecutar 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 de tu app en la misma página.

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.