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