Method: hashList.get
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Receber o conteúdo mais recente de uma lista de hash. Uma lista de hash pode ser gerada por uma lista de ameaças ou não relacionada a ameaças, como o cache global.
Esse é um método GET padrão, conforme definido por https://google.aip.dev/131 (link em inglês), 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 hash 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 hash, esse campo PRECISA ser deixado em branco. Caso contrário, o cliente DEVE fornecer a versão recebida anteriormente do servidor. O cliente NÃO PODE manipular esses bytes. Novidades na V5: na V4 da API, esse recurso era chamado de states. Agora, ele foi renomeado como version para maior clareza. Uma string codificada em base64.
|
desiredHashLength |
enum (HashLength)
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 desiredHashLength. Isso pode ser encontrado no campo supportedHashLengths em HashListMetadata. Se desiredHashLength não especificar um valor dentro de supportedHashLengths, será retornado um erro.
|
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 2024-04-01 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 2024-04-01 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"]]
