Method: hashLists.batchGet
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 plusieurs fois la méthode Get standard.
Il s'agit d'une méthode Get par lot standard, telle que définie sur https://google.aip.dev/231. La méthode HTTP est également GET.
Requête HTTP
GET https://safebrowsing.googleapis.com/v5/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. Il peut s'agir d'une liste de menaces ou du cache global. Les noms NE DOIVENT PAS contenir de doublons. Sinon, le client recevra une erreur.
|
version[] |
string (bytes format)
Versions de la liste de hachage que le client possède déjà. Si le client récupère les listes de hachage pour la première fois, le champ doit rester 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 moins ou plus de versions dans une requête que de noms. Toutefois, le client NE DOIT PAS envoyer plusieurs versions correspondant au même nom. Sinon, il recevra une erreur. Remarque historique: dans la version 4 de l'API, cette valeur était appelée states. Elle est désormais renommée version pour plus de clarté. Chaîne encodée en base64.
|
sizeConstraints |
object (SizeConstraints)
Contraintes de taille pour chaque liste. Si elle est omise, aucune contrainte ne s'applique. Notez que les tailles indiquées ici sont par liste et non agrégées pour toutes les 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 dans l'ordre indiqué dans la requête.
|
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 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Method: hashLists.batchGet\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchGetHashListsResponse.SCHEMA_REPRESENTATION)\n\nGet multiple hash lists at once.\n\nIt is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times.\n\nThis is a standard batch Get method as defined by \u003chttps://google.aip.dev/231\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `names[]` | `string` Required. The names of the particular hash lists. The list MAY be a threat list, or it may be the Global Cache. The names MUST NOT contain duplicates; if they did, the client will get an error. |\n| `version[]` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The versions of the hash list that the client already has. If this is the first time the client is fetching the hash lists, the field should be left empty. Otherwise, the client should supply the versions previously received from the server. The client MUST NOT manipulate those bytes. The client need not send the versions in the same order as the corresponding list names. The client may send fewer or more versions in a request than there are names. However the client MUST NOT send multiple versions that correspond to the same name; if it did, the client will get an error. Historical note: in V4 of the API, this was called `states`; it is now renamed to `version` for clarity. A base64-encoded string. |\n| `sizeConstraints` | `object (`[SizeConstraints](/safe-browsing/reference/rest/v5/SizeConstraints)`)` The size constraints on each list. If omitted, there are no constraints. Note that the sizes here are per-list, not aggregated across all lists. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response containing multiple hash lists.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------|\n| ``` { \"hashLists\": [ { object (/safe-browsing/reference/rest/v5/hashList#HashList) } ] } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `hashLists[]` | `object (`[HashList](/safe-browsing/reference/rest/v5/hashList#HashList)`)` The hash lists in the same order given in the request. |"]]
