Method: hashList.get

Receba o conteúdo mais recente de uma lista de hashes. Uma lista de hashes pode ser uma lista de ameaças ou não, como o cache global.

Este é um método GET padrão, conforme definido em https://google.aip.dev/131, e o método HTTP também é GET.

Solicitação HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome dessa lista de hashes específica. Pode ser uma lista de ameaças ou o cache global.

Parâmetros de consulta

Parâmetros
version

string (bytes format)

A versão da lista de hash que o cliente já tem. Se esta for a primeira vez que o cliente está buscando a lista de hashes, esse campo PRECISA ficar vazio. Caso contrário, o cliente PRECISA fornecer a versão recebida anteriormente do servidor. O cliente NÃO PODE manipular esses bytes.

Novidades na V5: 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.
sizeConstraints

object (SizeConstraints)

As restrições de tamanho na lista. Se omitido, não há restrições. As restrições são recomendadas em todos os dispositivos com capacidade de processamento, largura de banda ou armazenamento limitados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de HashList.