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 la méthode Get standard plusieurs fois.

Il s'agit d'une méthode Get par lot standard, telle que définie par https://google.aip.dev/231, et 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. La liste PEUT être une liste des menaces ou il peut s'agir du cache global. Les noms NE DOIVENT PAS contenir de doublons. si c'est le cas, le client obtient un message d'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 ce 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 des listes correspondantes. Le client peut envoyer dans une requête moins de versions ou plus 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 obtiendra un message d'erreur.

Remarque historique: Dans la version 4 de l'API, cette méthode s'appelait states. il est désormais renommé version pour plus de clarté.

Chaîne encodée en base64.

desiredHashLength

enum (HashLength)

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

Les différentes listes de hachage ont des exigences différentes en ce qui concerne 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.

Concernant 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 être divisé en plusieurs BatchGetHashListsRequest.

sizeConstraints

object (SizeConstraints)

Contraintes de taille sur chaque liste. S'il est omis, il n'y a aucune contrainte. Notez que les tailles indiquées ici correspondent à des listes, et non à des données cumulées pour 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 sont listées dans le même ordre que celui indiqué dans la requête.