Method: hashLists.batchGet

Receba várias listas de hash de uma só vez.

É muito comum que um cliente precise de várias listas de hash. É preferível usar esse método em vez de usar o método GET normal várias vezes.

Este é um método GET padrão em lote, conforme definido por https://google.aip.dev/231, e o método HTTP também é GET.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
names[]

string

Obrigatório. Os nomes das listas de hash específicas. A lista PODE ser uma lista de ameaças ou pode ser o cache global. Os nomes NÃO PODEM conter cópias; se tiverem, o cliente receberá um erro.
version[]

string (bytes format)

As versões da lista de hash que o cliente já tem. Se esta for a primeira vez que o cliente estiver buscando as listas de hash, o campo precisará ser deixado em branco. Caso contrário, o cliente precisará fornecer as versões recebidas anteriormente do servidor. O cliente NÃO PODE manipular esses bytes.

O cliente não precisa enviar as versões na mesma ordem que os nomes das listas correspondentes. O cliente pode enviar menos ou mais versões em uma solicitação do que nomes. No entanto, o cliente NÃO PODE enviar várias versões que correspondam ao mesmo nome. Se tiver enviado, o cliente receberá um erro.

Observação histórica: na V4 da API, era chamado de states. Agora, ele foi renomeado como version para maior clareza.

Uma string codificada em base64.
desiredHashLength

enum (HashLength)

O tamanho desejado do prefixo de hash dos hashes retornados em bytes. O servidor retornará todos os prefixos de hash nesse tamanho especificado.

Listas de hash diferentes têm requisitos distintos sobre os valores aceitáveis do campo desiredHashLength. Isso pode ser encontrado no campo supportedHashLengths em HashListMetadata. Se desiredHashLength não especificar um valor dentro de supportedHashLengths, um erro será retornado aos clientes.

Para o BatchGetHashListsRequest específico, não é possível que os clientes especifiquem um desiredHashLength diferente para listas diferentes. Se for necessário fazer isso, o cliente precisará ser dividido em várias BatchGetHashListsRequests.
sizeConstraints

object (SizeConstraints)

as restrições de tamanho em cada lista; Se omitido, não há restrições. Observe que os tamanhos são por lista, e não agregados em todas as listas.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A resposta que contém várias listas de hash.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "hashLists": [
    {
      object (HashList)
    }
  ]
}
Campos
hashLists[]

object (HashList)

O hash é listado na mesma ordem dada na solicitação.