Method: hashLists.batchGet

Obtenez plusieurs listes de hachage à 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 standard.

Il s'agit d'une méthode de récupération 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/v5alpha1/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. Il peut s'agir d'une liste de menaces ou du cache global. Les noms NE DOIVENT PAS contenir de doublons. Sinon, le client recevra une erreur.
version[]

string (bytes format)

Versions de la liste de hachage que le client possède déjà. Si le client récupère les listes de hachage pour la première fois, le champ doit rester 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 liste correspondants. Le client peut envoyer moins ou plus de versions dans une requête que de noms. Toutefois, le client NE DOIT PAS envoyer plusieurs versions correspondant au même nom. Sinon, il recevra une erreur.

Remarque historique: dans la version 4 de l'API, cette valeur était appelée states. Elle est désormais renommée version pour plus de clarté.

Chaîne encodée en base64.
desiredHashLength
(deprecated)

enum (HashLength)

Longueur du préfixe de hachage souhaité des hachages renvoyés en octets. Le serveur renvoie ensuite tous les préfixes de hachage de cette longueur spécifiée.

Les différentes listes de hachage ont des exigences différentes concernant les valeurs acceptables du champ desiredHashLength. Vous le trouverez dans le champ supportedHashLengths de HashListMetadata. Si desiredHashLength ne spécifie pas de valeur dans supportedHashLengths, une erreur est renvoyée aux clients.

Pour BatchGetHashListsRequest en particulier, les clients ne peuvent pas spécifier un desiredHashLength différent pour différentes listes. Si cela est nécessaire, le client doit se diviser en plusieurs BatchGetHashListsRequest.
sizeConstraints

object (SizeConstraints)

Contraintes de taille pour chaque liste. Si elle est omise, aucune contrainte ne s'applique. 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 listes de hachage dans l'ordre indiqué dans la requête.