Method: hashLists.batchGet

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

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

Esse é um método Get em lote padrão, 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 duplicados. Se isso acontecer, o cliente vai 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 deve ficar 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 menos ou mais versões em uma solicitação do que há nomes. No entanto, o cliente NÃO DEVE enviar várias versões que correspondam ao mesmo nome. Se isso acontecer, ele vai receber um erro.

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

Uma string codificada em base64.

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)

As listas de hash na mesma ordem da solicitação.