Method: hashLists.batchGet

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

É muito comum que um cliente precise acessar várias listas de hashes. É preferível usar esse método em vez do método Get normal várias vezes.

Este é um método padrão de lote GET, conforme definido em 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 o cache global. Os nomes NÃO podem conter duplicatas. Caso contrário, o cliente vai receber um erro.
version[]

string (bytes format)

As versões da lista de hashes que o cliente já tem. Se esta for a primeira vez que o cliente está buscando as listas de hash, o campo precisa estar vazio. Caso contrário, o cliente precisa 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 dos nomes de lista correspondentes. O cliente pode enviar mais ou menos 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 isso acontecer, o cliente vai receber um erro.

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

Uma string codificada em base64.
desiredHashLength
(deprecated)

enum (HashLength)

O comprimento do prefixo de hash desejado dos hashes retornados em bytes. O servidor vai retornar todos os prefixos de hash com esse comprimento especificado.

Diferentes listas de hashes têm requisitos diferentes para os valores aceitáveis do campo desiredHashLength. Ele pode ser encontrado no campo supportedHashLengths em HashListMetadata. Se desiredHashLength não especificar um valor em supportedHashLengths, um erro será retornado aos clientes.

Para o BatchGetHashListsRequest em particular, não é possível especificar um desiredHashLength diferente para listas diferentes. Se for necessário fazer isso, o cliente precisa se dividir em vários BatchGetHashListsRequests.
sizeConstraints

object (SizeConstraints)

As restrições de tamanho em cada lista. Se omitido, não há restrições. Os tamanhos aqui são por lista, 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 fornecida na solicitação.