Method: hashLists.batchGet

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

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

Esse é um método GET em lote padrão, 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 ele tiver sido feito, 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 está buscando as listas de hash, o campo deverá ser deixado em branco. Caso contrário, o cliente deverá 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 das listas correspondentes. O cliente pode enviar menos ou mais versões em uma solicitação do que há nomes. No entanto, o cliente NÃO PODE enviar várias versões que correspondem ao mesmo nome. Caso contrário, o cliente receberá um erro.

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

Uma string codificada em base64.

desiredHashLength

enum (HashLength)

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

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

Para a BatchGetHashListsRequest específica, não é possível que os clientes especifiquem um desiredHashLength diferente para listas diferentes. Se houver necessidade de fazer isso, o cliente precisará 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 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 contendo 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 lista na mesma ordem informada na solicitação.