Déclaration

Chaque déclaration s'adresse aux consommateurs. C'est celle qui la lit et la valide, puis prend des mesures en fonction de celle-ci. Plus précisément, un consommateur effectue les étapes de base suivantes:

  1. Demander la liste des relevés d'un compte principal spécifique
  2. Vérifier si la liste contient une instruction donnée par rapport à une cible donnée
  3. Confirmez que la cible indiquée dans l'énoncé correspond bien à la cible (site Web ou application) qui, selon vous, est
  4. Effectuez l'action spécifiée par l'instruction si vous le souhaitez

De nombreux cas d'utilisation consomment des affirmations qui vous sont destinées. Par exemple, Android App Linking utilise des déclarations d'autorisation de liens formulées par un site Web pour activer des liens directement dans une application. Une application indique qu'elle accepte de cibler 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).

Déclarations utilisant l'API Digital Asset Links

L'API Digital Asset Links accepte deux méthodes : Check() et List() pour rechercher ou valider des instructions:

  • Check() utilise une source, une cible et une relation, et vérifie que la source formule la déclaration envoyée concernant la cible.
  • List() répertorie toutes les instructions effectuées par une source donnée.

Consommation manuelle des instructions

Le protocole Digital Asset Links est ouvert. Vous pouvez donc l'implémenter vous-même.

Pour utiliser des instructions faites 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 des relevés pour le site Web http://example.digitalassetlinks.org est à l'adresse http://example.digitalassetlinks.org/.well-known/assetlinks.json.

Pour consulter les instructions envoyées par les applications Android, vous devez accéder au fichier manifeste du package APK correspondant. Sur les appareils Android, cela peut être effectué via l'interface PackageManager.

Veuillez prêter une attention particulière aux significations spécifiques des déclarations Digital Asset Links. En cas de doute, consultez les Spécifications des liens vers des éléments.