Method assetlinks.check

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

La relation décrit l'intention de l'association entre les deux éléments, telle que revendiquée par l'élément source. La délégation de droits ou d'autorisations en est un exemple.

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 est possible d'envoyer une URL Web vers une application mobile en particulier. Le client peut rechercher le lien d'élément pertinent entre le site Web et l'application mobile pour déterminer 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'assurera que toutes les instructions utilisées pour générer la réponse ont été faites de manière sécurisée par le propriétaire de cet élément. À l'inverse, si l'asset 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 valider ses instructions de manière sécurisée et il est impossible de garantir que les instructions du site Web 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 d'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 les chaînes au format <kind>/<detail>, où <kind> doit faire partie d'un ensemble de catégories d'objectifs prédéfinies, et <detail> est une chaîne alphanumérique à forme libre minuscule décrivant le cas d'utilisation spécifique de l'instruction.

Consultez la documentation de l'API pour obtenir la liste actuelle des relations compatibles.

Pour qu'une requête corresponde à un lien d'élément, les chaînes de relation de la requête et du lien d'é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) Élément 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 pour 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 requête sont liés par la relation spécifiée dans la requête. 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 des mises à jour sont effectuées. REQUIRED

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

Message dans un format lisible 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 le proposer pour le moment.

Notez que nous ne garantissons pas le contenu ni le format de cette chaîne. Tous ses aspects sont susceptibles d'être modifiés sans préavis. N'essayez pas d'analyser ces données par programmation. Si vous pensez que vous devez effectuer cette opération parce que l'API ne fournit pas les informations dont vous avez besoin, veuillez d'abord nous contacter.

Essayer

Utilisez APIs Explorer pour appeler cette méthode sur des données réelles et obtenir la réponse.