Method: hashList.get
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/04/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/04/01 (UTC)."],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"]]