Method: hashLists.batchGet

Récupère plusieurs listes de hachages à la fois.

Il est très courant qu'un client ait besoin d'obtenir plusieurs listes de hachage. Il est préférable d'utiliser cette méthode plutôt que d'utiliser plusieurs fois la méthode Get habituelle.

Il s'agit d'une méthode Get par lot standard, telle que définie par https://google.aip.dev/231. La méthode HTTP est également GET.

Requête HTTP

GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
names[]

string

Obligatoire. Noms des listes de hachage spécifiques. La liste PEUT être une liste de menaces ou le cache global. Les noms ne DOIVENT PAS contenir de doublons. Si c'était le cas, le client recevrait une erreur.
version[]

string (bytes format)

Versions de la liste de hachage dont le client dispose déjà. Si le client récupère les listes de hachage pour la première fois, le champ doit être laissé vide. Sinon, le client doit fournir les versions précédemment reçues du serveur. Le client NE DOIT PAS manipuler ces octets.

Le client n'a pas besoin d'envoyer les versions dans le même ordre que les noms de listes correspondants. Le client peut envoyer un nombre de versions inférieur ou supérieur au nombre de noms dans une requête. Toutefois, le client NE DOIT PAS envoyer plusieurs versions correspondant au même nom. S'il le fait, il recevra un message d'erreur.

Remarque historique : dans la version 4 de l'API, cette méthode s'appelait states. Elle a été renommée version pour plus de clarté.

Chaîne encodée en base64.
sizeConstraints

object (SizeConstraints)

Les contraintes de taille pour chaque liste. Si elle est omise, il n'y a aucune contrainte. Notez que les tailles indiquées ici sont par liste, et non agrégées pour toutes les listes.

Corps de la requête

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

Corps de la réponse

Réponse contenant plusieurs listes de hachage.

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

Représentation JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Champs
hashLists[]

object (HashList)

Les hachages sont listés dans le même ordre que dans la requête.