Ogni istruzione è concepita tenendo conto di un consumatore: quest'ultima è quella che legge e verifica una dichiarazione fatta da un'entità, quindi adotta misure basate su tale dichiarazione. Più nello specifico, un consumatore esegue questi passaggi di base:
- Richiedi l'elenco di istruzioni da un'entità specifica
- Controlla se l'elenco contiene una determinata istruzione in relazione a un determinato target
- Verifica che il target nell'istruzione sia il target (sito web o app) che ritieni che
- Esegui l'azione specificata dall'istruzione, se scegli di
Molti casi d'uso consumano affermazioni dietro le quinte. Ad esempio, Android App Linking consuma dichiarazioni relative alle autorizzazioni per i link rilasciate da un sito web allo scopo di attivare i link direttamente in un'app. Un'app indica che accetta di essere un target per tali istruzioni aggiungendo codice speciale (un gestore di intent) nel suo manifest.
Puoi eseguire i passaggi 1 e 2 precedenti, richiedendo e convalidando una dichiarazione, in due modi: utilizzando la nostra API o manualmente (utilizzando la tua implementazione).
Utilizzare le dichiarazioni utilizzando l'API Digital Asset Links
L'API Digital Asset Links supporta due metodi: Check() e List() per trovare o convalidare le dichiarazioni:
Check()prende una sorgente, un target e una relazione e verifica che la fonte faccia la dichiarazione inviata in merito al target.List()elenca tutte le istruzioni fornite da una determinata fonte.
Utilizzo manuale delle istruzioni
Il protocollo Digital Asset Links è aperto, quindi puoi crearne uno autonomamente.
Per consumare istruzioni fatte dai siti web, puoi effettuare una richiesta HTTP GET per l'elenco di istruzioni corrispondente e analizzarla autonomamente. Ad esempio, l'elenco delle istruzioni corrispondente per il sito web http://example.digitalassetlinks.org si trova all'indirizzo http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Per utilizzare le dichiarazioni effettuate dalle app per Android, devi accedere al manifest del pacchetto APK corrispondente. Sui dispositivi Android, puoi eseguire questa operazione utilizzando l'interfaccia PackageManager.
Presta particolare attenzione ai significati specifici delle dichiarazioni Digital Asset Links. In caso di dubbi, consulta la sezione Specifica dei link agli asset.