Method assetlinks.check

Détermine si la relation (directive) spécifiée existe entre les éléments source et cible spécifiés.

La relation décrit l'objectif du lien entre les deux éléments tels qu'ils sont revendiqués par l'élément source. La délégation de privilèges ou d'autorisations est un exemple de ce type de relations.

Cette commande est le plus souvent utilisée par les systèmes d’infrastructure pour vérifier les conditions préalables d’une action. Par exemple, un client peut vouloir savoir s'il peut envoyer une URL Web à une application mobile donnée à la place. Le client peut vérifier si le lien vers l'asset est pertinent entre le site Web et l'application mobile afin de décider si l'opération doit être autorisée.

Remarque concernant la sécurité: Si vous spécifiez un élément sécurisé comme source, comme un site Web HTTPS ou une application Android, l'API s'assure que toutes les instructions utilisées pour générer la réponse ont été effectuées de manière sécurisée par le propriétaire de cet élément. À l'inverse, si l'élément source est un site Web HTTP non sécurisé (c'est-à-dire que l'URL commence par http:// au lieu de https://), l'API ne peut pas vérifier ses instructions de manière sécurisée, et il est impossible de vérifier qu'elles n'ont pas été modifiées par un tiers. Pour en savoir plus, consultez les spécifications de conception technique de Digital Asset Links.

Requête HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Paramètres de requête

Nom du paramètre Type Description
source object(Asset) Source hébergeant la liste des instructions. Cela permet d'acheminer l'appel Check() vers la source appropriée.
relation string

Chaîne de requête pour la relation.

Nous identifions les relations avec des chaînes au format <kind>/<detail>, où <kind> doit faire partie d'un ensemble de catégories de finalité prédéfinies, et <detail> est une chaîne alphanumérique minuscule de forme libre qui décrit le cas d'utilisation spécifique de l'instruction.

Reportez-vous à la documentation de l'API pour obtenir la liste actuelle des relations acceptées.

Pour qu'une requête corresponde à un lien d'élément, les chaînes de relation de la requête et du lien de l'élément doivent correspondre exactement.

Exemple: une requête avec la relation delegate_permission/common.handle_all_urls correspond à un lien d'élément avec la relation delegate_permission/common.handle_all_urls.
target object(Asset) Composant cible de l'instruction.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Message de réponse à l'appel CheckAssetLinks.

Représentation JSON 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
fieldName Type Description
linked boolean Défini sur "true" si les éléments spécifiés dans la demande sont associés par la relation spécifiée dans celle-ci. REQUIRED
maxAge string

À partir de la date de diffusion, délai pendant lequel la réponse doit être considérée comme valide, sauf si d'autres mises à jour sont disponibles. REQUIRED

Durée en secondes avec neuf chiffres au maximum après la virgule. Se termine par "s". Example : "3.5s".
debugString string

Message lisible par l'humain contenant des informations destinées à aider les utilisateurs finaux à comprendre, à reproduire et à déboguer le résultat.

Le message sera en anglais et nous ne prévoyons pas de proposer de traduction pour le moment.

Notez qu'aucune garantie n'est faite quant au contenu ou au format de cette chaîne. Tout aspect du contenu est susceptible d'être modifié sans préavis. N'essayez pas d'analyser ces données de manière programmatique. Si vous pensez avoir besoin de le faire parce que les informations dont vous avez besoin ne sont pas divulguées par l'API, veuillez d'abord nous contacter.

Essayer

Utilisez l'explorateur d'API pour appeler cette méthode sur des données actives et obtenir la réponse.