Method statements.list

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

L'API garantit que toutes les instructions comportant des éléments sources sécurisés, tels que les sites Web HTTPS ou les applications Android, ont été créé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. En particulier, vous devez tenir compte du fait que cette garantie ne peut pas être fournie pour les sites Web non sécurisés (c'est-à-dire, lorsque l'URL commence par http:// au lieu de https://).

La commande List est particulièrement utile lorsque le client API souhaite connaître toutes les manières dont deux éléments sont liés ou énumérer toutes les relations d'un élément source particulier. Exemple: une fonctionnalité qui aide les utilisateurs à naviguer vers des éléments connexes. Lorsqu'une application mobile est exécutée sur un appareil, cette fonctionnalité facilite l'accès au site Web ou au profil Google+ correspondant.

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 des instructions. Cela permet de diriger la requête List() vers la source appropriée. REQUIRED
relation string

Utilisez uniquement les associations qui correspondent à 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:

  • que les chaînes de relation de la requête et de l'instruction correspondent exactement, ou
  • 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 à l'appel de 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 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.

Propos

Énoncé fiable concernant la relation entre un élément source et un élément cible.

Les déclarations sont toujours effectuées par l'élément source, soit directement, soit en déléguant l'accès à une liste d'instructions stockée ailleurs.

Pour obtenir une définition plus détaillée des instructions et des éléments, consultez la page de destination de la 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é ayant émis la déclaration). Chaque énoncé complet a une 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.

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

Essayer

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