Obtén varias listas de hash a la vez.
Es muy común que un cliente necesite obtener varias listas de hash. Es preferible usar este método en lugar del método Get normal varias veces.
Este es un método Get por lotes estándar, como se define en https://google.aip.dev/231, y el método HTTP también es GET.
Solicitud HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
names[] |
Obligatorio. Los nombres de las listas de hash específicas. La lista PUEDE ser una lista de amenazas o puede ser la caché global. Los nombres NO DEBEN contener duplicados; si lo hizo, el cliente recibirá un error. |
version[] |
Las versiones de la lista de hash que ya tiene el cliente. Si es la primera vez que el cliente recupera las listas de hash, el campo debe dejarse vacío. De lo contrario, el cliente debe proporcionar las versiones que recibió anteriormente del servidor. El cliente NO DEBE manipular esos bytes. No es necesario que el cliente envíe las versiones en el mismo orden que los nombres de lista correspondientes. El cliente puede enviar menos o más versiones en una solicitud que los nombres que existen. Sin embargo, el cliente NO DEBE enviar múltiples versiones que correspondan al mismo nombre. si lo hizo, el cliente recibirá un error. Nota histórica: En la versión 4 de la API, se llamaba String codificada en base64. |
desiredHashLength |
La longitud deseada del prefijo de hash de los hashes mostrados en bytes. Luego, el servidor mostrará todos los prefijos hash en esta longitud especificada. Las diferentes listas de hash tienen requisitos distintos en cuanto a los valores aceptables del campo Para el |
sizeConstraints |
Las restricciones de tamaño de cada lista. Si se omite, no se aplicarán restricciones. Ten en cuenta que los tamaños que se muestran aquí son por lista, no agregados en todas las listas. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
La respuesta que contiene varias listas de hash.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"hashLists": [
{
object ( |
Campos | |
---|---|
hashLists[] |
El hash enumera en el mismo orden que se indica en la solicitud. |