Method: hashLists.batchGet

Obtén 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 de usar el método Get normal varias veces.

Este es un método de 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[]

string

Es obligatorio. Los nombres de las listas de hash en particular La lista PUEDE ser una lista de amenazas o la caché global. Los nombres NO DEBEN contener duplicados. De lo contrario, el cliente recibirá un error.
version[]

string (bytes format)

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.

El cliente no necesita enviar 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 que la cantidad de nombres. Sin embargo, el cliente NO DEBE enviar varias versiones que correspondan al mismo nombre. De lo contrario, el cliente recibirá un error.

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

String codificada en base64.
desiredHashLength
(deprecated)

enum (HashLength)

Es la longitud deseada del prefijo de hash de los valores hash que se muestran en bytes. Luego, el servidor mostrará todos los prefijos de hash con esta longitud especificada.

Las diferentes listas de hash tienen diferentes requisitos para los valores aceptables del campo desiredHashLength. Puedes encontrarlo en el campo supportedHashLengths en HashListMetadata. Si desiredHashLength no especifica un valor dentro de supportedHashLengths, se mostrará un error a los clientes.

En el caso de BatchGetHashListsRequest en particular, los clientes no pueden especificar un desiredHashLength diferente para diferentes listas. Si es necesario, el cliente debe dividirse en varios BatchGetHashListsRequest.
sizeConstraints

object (SizeConstraints)

Las restricciones de tamaño de cada lista Si se omite, no hay restricciones. Ten en cuenta que los tamaños 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 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 (HashList)
    }
  ]
}
Campos
hashLists[]

object (HashList)

Las listas de hash en el mismo orden que se indica en la solicitud