Method: hashLists.batchGet

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.

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 correspondam 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.

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.

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.