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[] |
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[] |
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 Chaîne encodée en base64. |
desiredHashLength |
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 Concernant |
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 ( |
Champs | |
---|---|
hashLists[] |
Les listes de hachage sont listées dans le même ordre que celui indiqué dans la requête. |