Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/06/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/06/26 (UTC)."],[[["\u003cp\u003eDigital Asset Links enable websites and apps to make statements about their relationships, which other apps and services can then verify and act upon.\u003c/p\u003e\n"],["\u003cp\u003eYou can consume these statements using the Digital Asset Links API (\u003ccode\u003eCheck()\u003c/code\u003e and \u003ccode\u003eList()\u003c/code\u003e methods) or manually by retrieving and parsing the statement list.\u003c/p\u003e\n"],["\u003cp\u003eBefore implementing your own solution, check if existing mechanisms like Android App Linking already handle your desired scenario.\u003c/p\u003e\n"],["\u003cp\u003eWebsites publish their statements in a JSON file located at \u003ccode\u003e.well-known/assetlinks.json\u003c/code\u003e, while Android app statements are found within their manifest file.\u003c/p\u003e\n"],["\u003cp\u003eFor a deeper understanding of statement meanings and the underlying protocol, refer to the Asset Links Specification.\u003c/p\u003e\n"]]],[],null,["# Consuming a statement\n\nEvery statement is designed with a *consumer* in mind; the statement consumer is the one who reads and verifies a statement made by a principal, then takes action based on that statement. More specifically, a consumer performs these basic steps:\n\n1. Request the statement list from a specific principal\n2. Check to see if the list contains a given statement against a given target\n3. Validate that the target in the statement is the target (website or app) that you think it is\n4. Perform the action specified by the statement, if you choose to\n\n[Many use cases](/digital-asset-links/v1/using) consume statements for you behind the scenes. For example, Android App Linking consumes link permission statements made by a website to enable links directly into an app. An app indicates that it agrees to be a target to any such statements by adding special code (an intent handler) in its manifest.\n| Be sure to check that your scenario doesn't have a special mechanism for consuming or implementing a statement before handling it manually.\n\nYou can perform steps 1 and 2 above --- requesting and validating a statement --- in two ways: using our API or manually (using your own implementation).\n\nConsuming statements using the Digital Asset Links API\n------------------------------------------------------\n\n**The Digital Asset Links API** supports two methods: `Check()` and `List()` to find or validate statements:\n\n- [Check()](/digital-asset-links/reference/rest) takes a source, target, and relationship and verifies that the source makes the submitted statement about the target.\n- [List()](/digital-asset-links/reference/rest) lists all statements made by a given source.\n\n| In order to use the API, you need an [API key](https://support.google.com/googleapi/answer/6158862) and you must first activate the API for your project. To do that, follow these steps:\n|\n| 1. Go to the [Google Developers Console](https://console.developers.google.com/project/_/apiui/apiview/digitalassetlinks/overview).\n|\n| The console might require you to sign in first.\n| 2. Select or create a project.If you have multiple projects, make sure that you are in the project for which you want to activate the Digital Asset Links API and click **Continue** . Or, if you do not have a project, select **Create a new project** and click **Create**.\n|\n| 3. In the Digital Asset Links API overview, click **Enable API** .\n|\n| If the API is already enabled for your project, you will see **Disable API**.\n| 4. In the left-hand menu, click on **Credentials** and either select or create an API key.\n|\n| [More information about creating API keys](https://support.google.com/googleapi/answer/6158862).\n\nConsuming statements manually\n-----------------------------\n\nThe Digital Asset Links protocol is open, so you can create an implementation of it for yourself.\n\nTo consume statements made by **web sites** , you can make an HTTP GET request for the corresponding statement list and parse it yourself. For example, the corresponding statement list for the web site `http://example.digitalassetlinks.org` is at `http://example.digitalassetlinks.org/.well-known/assetlinks.json`.\n\nTo consume statements made by **Android apps** , you need to access the manifest of the corresponding APK package. On Android devices, this can be accomplished using the [PackageManager](http://developer.android.com/reference/android/content/pm/PackageManager.html) interface.\n\nPlease pay special attention to the specific meanings of Digital Asset Links statements. Refer to the [Asset Links Specification](https://github.com/google/digitalassetlinks/blob/master/well-known/details.md) if you are unsure."]]
