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[] |
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[] |
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 Uma string codificada em base64. |
desiredHashLength |
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 Para o |
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 ( |
Campos | |
---|---|
hashLists[] |
O hash é listado na mesma ordem dada na solicitação. |