La liste ou l'extrait d'instruction se compose des éléments suivants :
Un tableau JSON contenant une ou plusieurs instructions de site Web ou d'application en tant qu'objets JSON. Ces instructions peuvent être dans n'importe quel ordre. Voici la syntaxe générale:
Tableau d'une ou de 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
cible
Composant cible auquel cette instruction s'applique. Types de cibles disponibles :
L'URI du site qui est la cible de l'instruction, au format http[s]://<hostname>[:<port>], où <hostname> est complet et <port> doit être omis si vous utilisez le port 80 pour HTTP ou le port 443 pour HTTPS. Une cible de site Web ne peut être qu'un domaine racine. Vous ne pouvez pas vous limiter à un sous-répertoire spécifique. Tous les répertoires sous ce répertoire correspondent. Les sous-domaines ne doivent pas être considérés comme identiques : si le fichier d'instruction est hébergé sur www.example.com, www.puppies.example.com ne doit pas être considéré comme une correspondance. Pour obtenir des règles et des exemples de mise en correspondance des cibles de sites Web, consultez la documentation sur les cibles. Exemple:http://www.example.com
Doit être android_app pour les applications Android.
package_name
Nom complet du package de l'application à laquelle cette instruction s'applique. Example :com.google.android.apps.maps
sha256_cert_fingerprints
Empreinte SHA265 en majuscules du certificat de l'application à laquelle cette instruction s'applique. Vous pouvez le calculer à l'aide de
openssl ou de Java keytool, comme illustré ci-dessous :
Si vous utilisez la signature d'application Play pour votre application, l'empreinte de certificat produite en exécutant keytool ou openssl localement ne correspond généralement pas à celle qui se trouve sur les appareils des utilisateurs. Vous pouvez vérifier si vous utilisez la signature d'application Play pour votre application dans votre
Compte de développeur Play Console
moins de Release > Setup > App Integrity ; si oui,
vous trouverez également l'extrait JSON Digital Asset Links correspondant à votre application sur le
.
Dans certains cas, le compte principal peut vouloir formuler de nombreuses affirmations différentes.
sur les différents objectifs, ou il peut être nécessaire de faire des déclarations
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 faire une déclaration sur la même application mobile.
Dans ce cas, il peut être utile d'inclure des instructions.
Ce mécanisme vous permet de configurer des pointeurs provenant 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 contenir le même contenu que dans les exemples ci-dessus.
Pour configurer un pointeur d'un site Web vers le fichier d'inclusion :
Remplacez "https://example.com/.well-known/assetlinks.json" par:
Pour en savoir plus sur le format de la liste d'énoncés et les concepts sous-jacents, consultez notre document de spécifications.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eA statement list is a JSON file that describes relationships between websites and Android apps, used for features like Digital Asset Links.\u003c/p\u003e\n"],["\u003cp\u003eThe list consists of statements with "relation" and "target" fields, where "target" can be a website or an Android app.\u003c/p\u003e\n"],["\u003cp\u003eWebsite targets are specified using a "site" field with a URL, while Android app targets use "package_name" and "sha256_cert_fingerprints".\u003c/p\u003e\n"],["\u003cp\u003eFor many statements, use "include" to point to a central file to avoid redundancy and simplify management.\u003c/p\u003e\n"],["\u003cp\u003eDetailed syntax and examples are provided to guide you in creating and using statement lists effectively.\u003c/p\u003e\n"]]],[],null,["# Statement List Syntax\n\nA statement list is a [JSON-encoded](http://json.org/) file or snippet in a well-known location.\n\nLocation of statement list\n--------------------------\n\nSee [Creating a statement list](/digital-asset-links/v1/create-statement) to learn where this list should be stored.\n\nSyntax\n------\n\nThe statement list or snippet consists of\na JSON array of one or more website or app statements as JSON objects. These statements can be in any order. Here is the general syntax: \n\n```\n[\n {\n \"relation\": [\"relation_string\"],\n \"target\": {target_object}\n } , ...\n]\n```\n\nrelation\n: An array of one or more strings that describe the relation being declared about the target. See the list of [defined relation strings](/digital-asset-links/v1/relation-strings). **Example:** `delegate_permission/common.handle_all_urls`\n\ntarget\n: The target asset to whom this statement applies. Available target types:\n\n - **Website target** \n\n ```javascript\n \"target\": {\n \"namespace\": \"web\",\n \"site\": \"\u003cvar translate=\"no\"\u003esite_root_url\u003c/var\u003e\"\n }\n ```\n\n namespace\n : Must be `web` for websites.\n\n site\n : URI of the site that is the target of the statement, in the format `http[s]://\u003c`\u003cvar translate=\"no\"\u003ehostname\u003c/var\u003e`\u003e[:\u003c`\u003cvar translate=\"no\"\u003eport\u003c/var\u003e`\u003e]`, where \u003cvar translate=\"no\"\u003e<hostname>\u003c/var\u003e is fully-qualified, and \u003cvar translate=\"no\"\u003e<port>\u003c/var\u003e must be omitted when using port 80 for HTTP, or port 443 for HTTPS. A website target can only be a root domain; you cannot limit to a specific subdirectory; all directories under this root will match. Subdomains should not be considered to match: that is, if the statement file is hosted on www.example.com, then www.puppies.example.com should not be considered a match. For rules and examples about website target matching, see [the targets documentation](/digital-asset-links/v1/create-statement#targets). **Example:** `http://www.example.com`\n - **Android app target** \n\n ```javascript\n \"target\": {\n \"namespace\": \"android_app\",\n \"package_name\": \"\u003cvar translate=\"no\"\u003efully_qualified_package_name\u003c/var\u003e\",\n \"sha256_cert_fingerprints\": [\"\u003cvar translate=\"no\"\u003ecert_fingerprint\u003c/var\u003e\"]\n }\n ```\n\n namespace\n : Must be `android_app` for Android apps.\n\n package_name\n : The fully-qualified package name of the app that this statement applies to. **Example:** `com.google.android.apps.maps`\n\n sha256_cert_fingerprints\n : The **uppercase SHA265 fingerprint** of the certificate for the app that this\n statement applies to. You can compute this using [`\n openssl`](https://www.openssl.org/) or Java `keytool` as shown here:\n - `openssl x509 -in $CERTFILE -noout -fingerprint -sha256`\n - `keytool -printcert -file $CERTFILE | grep SHA256`\n\n\n **Example:** `[\"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\"]`.\n\n If you're using [Play App Signing](https://support.google.com/googleplay/android-developer/answer/9842756)\n for your app, then the certificate fingerprint produced by running `keytool`\n or `openssl` locally usually doesn't match the one on\n users' devices. You can verify whether you're using Play App Signing for your app in your\n [Play Console](https://play.google.com/console/) developer account\n under **Release \\\u003e Setup \\\u003e App Integrity**; if you do,\n then you'll also find the correct Digital Asset Links JSON snippet for your app on the same\n page.\n\nExample statement list\n----------------------\n\nHere is an example website statement list that contains statements about both websites and apps: \u003chttp://example.digitalassetlinks.org/.well-known/assetlinks.json\u003e\n\nScaling to dozens of statements or more\n---------------------------------------\n\nIn some cases, a principal might want to make many different statements\nabout different targets, or there might be a need to issue statements from\ndifferent principals to the same set of targets. For example, a website may\nbe available on many different per-country Top Level Domains, and all of them\nmay want to make a statement about the same mobile app.\n\nFor these situations, **include statements** can be helpful.\nUsing this mechanism, you can set up pointers from many different principals to\none central location, which defines statements for all of the principals.\n| **Note:** A maximum of 10 include statements are allowed in a complete statement list tree. This means that the maximum number of files in the tree is: (10 included statement files) + (the root statement file) = 11 total.\n\nFor example, you might decide that the central location\nshould be \\`https://example.com/includedstatements.json\\`. This file can be\nconfigured to contain the same content as in the examples above.\n\nTo set up a pointer from a **web site** to the include file,\nchange \\`https://example.com/.well-known/assetlinks.json\\` to: \n\n```text\n[{\n \"include\": \"https://example.com/includedstatements.json\"\n}]\n```\n\nTo set up a pointer from an **Android app** to the include\nfile, change \\`res/values/strings.xml\\` to: \n\n```scdoc\n\u003cresources\u003e\n ...\n \u003cstring name=\"asset_statements\"\u003e\n [{\n \\\"include\\\": \\\"https://example.com/includedstatements.json\\\"\n }]\n \u003c/string\u003e\n\u003c/resources\u003e\n```\n\nMore Information\n----------------\n\nThere is a more detailed explanation of the statement list format and the underlying concepts in our [specification document](https://github.com/google/digitalassetlinks/blob/master/well-known/details.md)."]]
