Method: hashLists.batchGet

Obtenez plusieurs listes de hachage à la fois.

Il est très courant pour un client d'avoir besoin de plusieurs listes de hachage. Cette méthode est préférable à l'utilisation répétée de la méthode Get standard.

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/v5alpha1/hashLists:batchGet

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
names[]

string

Obligatoire. Les noms des listes de hachage concernées. Il peut s'agir d'une liste des menaces ou il peut s'agir du cache global. Les noms NE DOIVENT PAS contenir de doublons ; si tel est le cas, le client recevra une erreur.
version[]

string (bytes format)

Versions de la liste de hachage dont dispose déjà le client. Si c'est la première fois que le client récupère les listes de hachage, laissez le champ 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 plus ou moins de versions dans une requête qu'il n'y a de noms. Cependant, le client NE DOIT PAS envoyer plusieurs versions correspondant au même nom. Si c'est le cas, le client recevra un message d'erreur.

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

Chaîne encodée en base64.
desiredHashLength

enum (HashLength)

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

Les listes de hachage n'ont pas les mêmes exigences concernant les valeurs acceptables pour le champ desiredHashLength. Vous le trouverez dans le champ supportedHashLengths du fichier 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 autre desiredHashLength pour différentes listes. Si cette opération est nécessaire, le client doit le diviser en plusieurs BatchGetHashListsRequest.
sizeConstraints

object (SizeConstraints)

Les contraintes de taille appliquées à chaque liste. Si cette valeur est omise, il n'y a aucune contrainte. Notez que les tailles indiquées ici correspondent à chaque liste, et non à l'ensemble des 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 le même ordre que celui indiqué dans la requête.