Method: hashLists.batchGet

Obtiene varias listas de hash a la vez.

Es muy común que un cliente necesite obtener varias listas de hash. Se prefiere usar este método en lugar del método Get normal varias veces.

Este es un método Get por lotes estándar según lo define https://google.aip.dev/231, y el método HTTP también es GET.

Solicitud HTTP

GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
names[]

string

Obligatorio. Son los nombres de las listas de hash específicas. La lista PUEDE ser una lista de amenazas o la caché global. Los nombres NO deben contener duplicados. Si lo hicieran, el cliente recibirá un error.

version[]

string (bytes format)

Son 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 quedar 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 las listas correspondientes. El cliente puede enviar menos o más versiones en una solicitud de las que hay nombres. Sin embargo, el cliente NO DEBE enviar varias versiones que correspondan al mismo nombre. Si lo hiciera, el cliente recibirá un error.

Nota histórica: En la versión 4 de la API, esto se llamaba states. Ahora, se cambió el nombre a version para mayor claridad.

String codificada en base64.

sizeConstraints

object (SizeConstraints)

Son las restricciones de tamaño en cada lista. Si se omite, no hay restricciones. Ten en cuenta que los tamaños que se indican 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

Es la respuesta que contiene varias listas de hashes.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Campos
hashLists[]

object (HashList)

Son las listas de hash en el mismo orden que se indica en la solicitud.