Method: hashList.get
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-03-06 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-03-06 UTC."],[[["Get the latest contents of a hash list, which can be a threat list or the Global Cache, using a standard GET method."],["The `name` path parameter specifies the hash list to retrieve."],["Provide the `version` query parameter to indicate the client's current hash list version or leave it empty for the initial fetch."],["Optionally, specify the desired hash prefix length using the `desiredHashLength` query parameter and set size constraints with the `sizeConstraints` parameter."],["The response body will contain the requested `HashList` data."]]],["This document details retrieving a hash list (threat or non-threat) using a `GET` request. The URL is structured as `https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}`, with `name` being a required path parameter. Optional query parameters include `version` (client's current list version), `desiredHashLength` (hash prefix length), and `sizeConstraints` (list size limits). The request body is empty, and a successful response returns a `HashList` instance.\n"]]
