L'elenco o lo snippet di istruzioni è costituito da
un array JSON di una o più istruzioni di siti web o app come oggetti JSON. Queste istruzioni possono essere in qualsiasi ordine. Ecco la sintassi generale:
Un array di una o più stringhe che descrivono la relazione dichiarata in merito alla destinazione. Consulta l'elenco delle stringhe di relazione definite. Esempio:delegate_permission/common.handle_all_urls
target
L'asset di destinazione a cui si applica questa dichiarazione. Tipi di target disponibili:
URI del sito di destinazione dell'istruzione, nel formato http[s]://<hostname>[:<port>], dove <hostname> è completo e <port> deve essere omesso quando si utilizza la porta 80 per HTTP o la porta 443 per HTTPS. Un target del sito web può essere solo un dominio principale; non puoi limitarlo a una sottodirectory specifica; tutte le directory sotto questa radice corrisponderanno. I sottodomini non devono essere considerati corrispondenti: ovvero, se il file delle dichiarazioni è ospitato su www.example.com, www.puppies.example.com non deve essere considerato una corrispondenza. Per regole ed esempi sulla corrispondenza dei target dei siti web, consulta la documentazione sui target. Esempio:http://www.example.com
Il nome del pacchetto completo dell'app a cui si applica questa dichiarazione. Esempio:com.google.android.apps.maps
sha256_cert_fingerprints
L'impronta SHA256 in maiuscolo del certificato dell'app a cui si applica questa
dichiarazione. Puoi calcolarlo utilizzando
openssl o Java keytool come mostrato qui:
Se utilizzi la firma dell'app di Google Play
per la tua app, la fingerprint del certificato generata eseguendo keytool
o openssl localmente di solito non corrisponde a quella sui
dispositivi degli utenti. Puoi verificare se utilizzi la firma delle app di Google Play per la tua app nel tuo account sviluppatore
Play Console
nella sezione Release > Setup > App Integrity; in caso affermativo,
nella stessa pagina troverai anche lo snippet JSON Digital Asset Links corretto per la tua app.
relation_extensions (facoltativo)
Puoi aggiungere un campo relation_extensions facoltativo a un'affermazione per fornire maggiori informazioni sulle autorizzazioni e sulle associazioni che vuoi concedere. Questo campo deve essere un oggetto in cui ogni chiave è una stringa di relazione e il valore è un oggetto contenente le estensioni per quella relazione. I client che richiedono queste istruzioni devono essere aggiornati per rispettare questi campi.
Ad esempio, relation_extensions per la relazione delegate_permission/common.handle_all_urls potrebbe avere il seguente aspetto:
L'API DAL supporta la restituzione di relation_extensions nelle chiamate API quando il parametro return_relation_extensions=true è impostato nella richiesta.
In alcuni casi, un soggetto potrebbe voler fare molte dichiarazioni diverse
su target diversi oppure potrebbe essere necessario emettere dichiarazioni da
soggetti diversi allo stesso insieme di target. Ad esempio, un sito web potrebbe
essere disponibile su molti domini di primo livello per paese diversi e tutti
potrebbero voler fare una dichiarazione sulla stessa app mobile.
In queste situazioni, possono essere utili le dichiarazioni di inclusione.
Utilizzando questo meccanismo, puoi configurare puntatori da molti principal diversi a
una posizione centrale, che definisce le istruzioni per tutti i principal.
Ad esempio, potresti decidere che la posizione centrale
deve essere `https://example.com/includedstatements.json`. Questo file può essere
configurato in modo da contenere gli stessi contenuti degli esempi precedenti.
Per impostare un puntatore da un sito web al file di inclusione,
modifica `https://example.com/.well-known/assetlinks.json` in:
Nel nostro documento delle specifiche è disponibile una spiegazione più dettagliata del formato dell'elenco delle istruzioni e dei concetti sottostanti.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-09 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)."]]
