Method: hashList.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtén el contenido más reciente de una lista de hash. Una lista de hash puede ser una lista de amenazas o una lista que no es de amenazas, como la caché global.
Este es un método GET estándar, como se define en https://google.aip.dev/131, y el método HTTP también es GET.
Solicitud HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
name |
string
Es obligatorio. Es el nombre de esta lista de hash en particular. Puede ser una lista de amenazas o la caché global.
|
Parámetros de consulta
| Parámetros |
version |
string (bytes format)
Es la versión de la lista de hash que ya tiene el cliente. Si es la primera vez que el cliente recupera la lista de hash, este campo DEBE estar vacío. De lo contrario, el cliente DEBE proporcionar la versión que recibió anteriormente del servidor. El cliente NO DEBE manipular esos bytes. Novedades de la versión 5: En la versión 4 de la API, se llamaba states. Ahora, se cambió el nombre a version para brindar mayor claridad. String codificada en base64.
|
desiredHashLength
(deprecated) |
enum (HashLength)
Es la longitud deseada del prefijo de hash de los valores hash que se muestran en bytes. Luego, el servidor mostrará todos los prefijos de hash con esta longitud especificada. Las diferentes listas de hash tienen diferentes requisitos para los valores aceptables del campo desiredHashLength. Puedes encontrarlo en el campo supportedHashLengths en HashListMetadata. Si desiredHashLength no especifica un valor dentro de supportedHashLengths, se mostrará un error.
|
sizeConstraints |
object (SizeConstraints)
Las restricciones de tamaño de la lista Si se omite, no hay restricciones. Se recomiendan restricciones en todos los dispositivos con potencia de procesamiento, ancho de banda o almacenamiento limitados.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de HashList.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-03-06 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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"]]
