Method: hashList.get

Récupérez le dernier contenu d'une liste de hachage. Une liste de hachage peut prendre la forme d'une liste des menaces ou d'une liste de non-menaces telle que le cache global.

Il s'agit d'une méthode Get standard telle que définie par https://google.aip.dev/131. La méthode HTTP est également GET.

Requête HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Le nom de cette liste de hachage spécifique. Il peut s’agir d’une liste de menaces ou cela peut être le cache global.

Paramètres de requête

Paramètres
version

string (bytes format)

Version de la liste de hachage déjà utilisée par le client. Si c'est la première fois que le client récupère la liste de hachage, ce champ DOIT être laissé vide. Sinon, le client DOIT fournir la version précédemment reçue du serveur. Le client NE DOIT PAS manipuler ces octets.

Nouveautés de la version 5: dans la version 4 de l'API, cette fonction s'appelait states. Pour plus de clarté, elle est désormais renommée version.

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.
sizeConstraints

object (SizeConstraints)

Contraintes de taille sur la liste. Si cette valeur est omise, il n'y a aucune contrainte. Les contraintes sont recommandées sur tous les appareils dont la puissance de traitement, la bande passante ou l'espace de stockage sont limités.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de HashList.