Ogni affermazione è pensata per un consumatore; il consumatore è colui che legge e verifica una dichiarazione fatta da un'entità, quindi agisce in base a questa dichiarazione. In particolare, un consumatore esegue questi passaggi di base:
- Richiedi l'elenco di istruzioni a un'entità specifica
- Verificare se l'elenco contiene una determinata istruzione rispetto a un determinato target
- Verifica che il target nell'affermazione sia il target (sito web o app) che pensi sia.
- Eseguire l'azione specificata dall'istruzione, se lo desideri
Molti casi d'uso sfruttano le istruzioni per te in background. Ad esempio, il collegamento di app Android utilizza le istruzioni di autorizzazione dei link effettuate da un sito web per attivare i link direttamente in un'app. Un'app indica che accetta di essere un target di tali dichiarazioni aggiungendo un codice speciale (un gestore di intent) nel file manifest.
Puoi eseguire i passaggi 1 e 2 precedenti, richiedendo e convalidando un'istruzione, in due modi: utilizzando la nostra API o manualmente (utilizzando la tua implementazione).
Utilizzo di dichiarazioni mediante 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, una destinazione e una relazione e verifica che sia la fonte a fare la dichiarazione inviata in merito al target.List()elenca tutte le dichiarazioni effettuate da una determinata fonte.
Utilizzo manuale degli estratti conto
Il protocollo Digital Asset Links è aperto, quindi puoi creare un'implementazione in autonomia.
Per utilizzare istruzioni fatte da siti web, è possibile effettuare una richiesta HTTP GET per l'elenco di istruzioni corrispondente ed analizzarla personalmente. Ad esempio, l'elenco di istruzioni corrispondente per il sito web http://example.digitalassetlinks.org è all'indirizzo http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Per utilizzare le istruzioni fatte dalle app Android, devi accedere al manifest del pacchetto APK corrispondente. Sui dispositivi Android, questa operazione può essere eseguita utilizzando l'interfaccia PackageManager.
Presta particolare attenzione ai significati specifici delle dichiarazioni relative ai link agli asset digitali. In caso di dubbi, consulta la Specifica dei collegamenti agli asset.