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/v5/hashList/{name}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
name |
string
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.
|
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-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Method: hashList.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nGet the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such as the Global Cache.\n\nThis is a standard Get method as defined by \u003chttps://google.aip.dev/131\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5/hashList/{name}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of this particular hash list. It may be a threat list, or it may be the Global Cache. |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `version` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The version of the hash list that the client already has. If this is the first time the client is fetching the hash list, this field MUST be left empty. Otherwise, the client SHOULD supply the version previously received from the server. The client MUST NOT manipulate those bytes. **What's new in V5** : in V4 of the API, this was called `states`; it is now renamed to `version` for clarity. A base64-encoded string. |\n| `sizeConstraints` | `object (`[SizeConstraints](/safe-browsing/reference/rest/v5/SizeConstraints)`)` The size constraints on the list. If omitted, there are no constraints. Constraints are recommended on all devices with limited processing power, bandwidth, or storage. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [HashList](/safe-browsing/reference/rest/v5/hashList#HashList)."]]
