Chaque instruction est conçue pour répondre aux besoins des consommateurs. C'est le consommateur qui lit et vérifie une déclaration effectuée par le compte principal, puis prend les mesures qui s'imposent en fonction de cette affirmation. Plus précisément, un consommateur effectue les étapes de base suivantes:
- Demander la liste des relevés à un compte principal spécifique
- Vérifier si la liste contient une instruction donnée par rapport à une cible donnée
- confirmer que la cible indiquée dans l'énoncé est bien la cible (site Web ou application) que vous estimez être
- Effectuez l'action spécifiée par l'instruction, si vous choisissez de
De nombreux cas d'utilisation utilisent automatiquement des instructions en arrière-plan. Par exemple, Android App Linking utilise les instructions d'autorisation de lien faites par un site Web pour activer les liens directement dans une application. Une application indique qu'elle accepte d'être une cible de ces instructions en ajoutant un code spécial (un gestionnaire d'intent) dans son fichier manifeste.
Vous pouvez effectuer les étapes 1 et 2 ci-dessus (demander et valider une instruction) de deux manières: à l'aide de notre API ou manuellement (avec votre propre implémentation).
Utiliser des instructions à l'aide de l'API Digital Asset Links
L'API Digital Asset Links accepte deux méthodes: Check() et List() pour rechercher ou valider des instructions:
Check()prend une source, une cible et une relation, puis vérifie que la source envoie l'instruction envoyée au sujet de la cible.List()liste toutes les instructions effectuées par une source donnée.
Consommer des instructions manuellement
Le protocole Digital Asset Links est ouvert. Vous pouvez donc en créer une implémentation pour vous-même.
Pour utiliser les instructions créées par des sites Web, vous pouvez envoyer une requête HTTP GET pour la liste d'instructions correspondante et l'analyser vous-même. Par exemple, la liste d'instructions correspondante pour le site Web http://example.digitalassetlinks.org se trouve à l'adresse http://example.digitalassetlinks.org/.well-known/assetlinks.json.
Pour utiliser les instructions émises par les applications Android, vous devez accéder au fichier manifeste du package APK correspondant. Sur les appareils Android, cette opération peut être effectuée à l'aide de l'interface PackageManager.
Veuillez prêter une attention particulière à la signification spécifique des déclarations Digital Asset Links. En cas de doute, consultez l'article Spécifications des liens vers des éléments.