Method: hashLists.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elencare gli elenchi di hash.
Nell'API V5, Google non rimuoverà mai un elenco hash restituito con questo metodo. In questo modo i clienti possono saltare l'utilizzo di questo metodo ed eseguire semplicemente l'hard-coding di tutti gli elenchi di hash di cui hanno bisogno.
Si tratta di un metodo List standard come definito da https://google.aip.dev/132, mentre il metodo HTTP è GET.
Richiesta HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
pageSize |
integer
Il numero massimo di elenchi di hash da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non sono specificate, il server sceglierà una dimensione della pagina, che può essere superiore al numero di elenchi di hash, in modo che l'impaginazione non sia necessaria.
|
pageToken |
string
Un token di pagina, ricevuto da una precedente chiamata a hashLists.list. Forniscilo per recuperare la pagina successiva.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
La risposta contenente i metadati sugli elenchi di hash.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"hashLists": [
{
object (HashList)
}
],
"nextPageToken": string
} |
| Campi |
hashLists[] |
object (HashList)
Gli hash elencati in ordine arbitrario. Saranno inclusi solo i metadati relativi agli elenchi di hash, non i contenuti.
|
nextPageToken |
string
Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eRetrieves a list of available hash lists with metadata, excluding their contents.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large sets of hash lists using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGoogle guarantees that hash lists once returned will never be removed, enabling client-side hardcoding.\u003c/p\u003e\n"],["\u003cp\u003eEmploys standard List method with a GET request to \u003ccode\u003ehttps://safebrowsing.googleapis.com/v5alpha1/hashLists\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes details about each hash list and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["This document details the process for retrieving metadata about hash lists using the V5 API's `hashLists.list` method. It uses an HTTP GET request to `https://safebrowsing.googleapis.com/v5alpha1/hashLists`. Optional query parameters include `pageSize` to limit results and `pageToken` for pagination. The request body must be empty. The response body includes an array of `hashLists` and an optional `nextPageToken` for subsequent pages. The API never removes returned hash lists.\n"],null,["# Method: hashLists.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListHashListsResponse.SCHEMA_REPRESENTATION)\n\nList hash lists.\n\nIn the V5 API, Google will never remove a hash list that has ever been returned by this method. This enables clients to skip using this method and simply hard-code all hash lists they need.\n\nThis is a standard List method as defined by \u003chttps://google.aip.dev/132\u003e and the HTTP method is GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5alpha1/hashLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of hash lists to return. The service may return fewer than this value. If unspecified, the server will choose a page size, which may be larger than the number of hash lists so that pagination is not necessary. |\n| `pageToken` | `string` A page token, received from a previous `hashLists.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response containing metadata about hash lists.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"hashLists\": [ { object (/safe-browsing/reference/rest/v5alpha1/hashList#HashList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `hashLists[]` | `object (`[HashList](/safe-browsing/reference/rest/v5alpha1/hashList#HashList)`)` The hash lists in an arbitrary order. Only metadata about the hash lists will be included, not the contents. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |"]]
