Method statements.list

Récupère une liste de toutes les instructions d'une source donnée qui correspondent à la cible et à la chaîne d'instructions spécifiées.

L'API garantit que toutes les instructions comportant des éléments sources sécurisés, comme des sites Web HTTPS ou des applications Android, ont été effectuées de manière sécurisée par le propriétaire de ces éléments, comme décrit dans les spécifications de conception technique de Digital Asset Links. Plus précisément, sachez que pour les sites Web non sécurisés (où l'URL commence par http:// au lieu de https://), cette garantie ne peut pas être effectuée.

La commande List est particulièrement utile lorsque le client API souhaite connaître toutes les relations entre deux éléments, ou énumérer toutes les relations d'un élément source particulier. Exemple: une fonctionnalité qui aide les utilisateurs à accéder aux éléments associés. Lorsqu'une application mobile s'exécute sur un appareil, cette fonctionnalité facilite l'accès au site Web ou au profil Google+ correspondants.

Requête HTTP :

GET https://digitalassetlinks.googleapis.com/v1/statements:list

Paramètres de requête

Nom du paramètre Type Description
source object(Asset) Source hébergeant la liste d'instructions. Cela permet de rediriger la requête List() vers la bonne source. REQUIRED
relation string

N'utilisez que des associations correspondant à la relation spécifiée.

Consultez le message Statement pour obtenir une définition détaillée des chaînes de relation.

Pour qu'une requête corresponde à une instruction, l'une des conditions suivantes doit être remplie:

  • Les chaînes de relation de la requête et de l'instruction correspondent exactement.
  • la chaîne de relation de la requête est vide ou manquante.

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.

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 de la liste.

Représentation JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
fieldName Type Description
statements[] object(Statement) Liste de toutes les instructions correspondantes trouvées.
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.

Propos

Décrit une déclaration fiable concernant la relation entre un élément source et un élément cible.

Les déclarations sont toujours faites par l'élément source, soit directement, soit en déléguant l'opération à une liste de relevés stockée ailleurs.

Pour obtenir des définitions plus détaillées des relevés et des éléments, veuillez consulter la page de documentation de l'API.

Représentation JSON 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
fieldName Type Description
source object(Asset) Chaque instruction est associée à un élément source. REQUIRED
relation string

La relation identifie l'utilisation de la déclaration telle que prévue par le propriétaire de l'élément source (c'est-à-dire la personne ou l'entité qui l'a émise). Chaque instruction complète a une 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.

Exemple: delegate_permission/common.handle_all_urls OBLIGATOIRE
target object(Asset) Chaque instruction a un élément cible. REQUIRED

Essayer

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