Method: fullHashes.find
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Trova gli hash completi che corrispondono ai prefissi hash richiesti.
Richiesta HTTP
POST https://safebrowsing.googleapis.com/v4/fullHashes:find
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"client": {
object (ClientInfo)
},
"clientStates": [
string
],
"threatInfo": {
object (ThreatInfo)
},
"apiClient": {
object (ClientInfo)
}
} |
| Campi |
client |
object (ClientInfo)
I metadati del client.
|
clientStates[] |
string (bytes format)
L'attuale stato del client per ciascun elenco di minacce locali. Una stringa con codifica base64.
|
threatInfo |
object (ThreatInfo)
Gli elenchi e gli hash da controllare.
|
apiClient |
object (ClientInfo)
Metadati del client associati ai chiamanti delle API di livello superiore basati sull'implementazione del client.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"matches": [
{
object (ThreatMatch)
}
],
"minimumWaitDuration": string,
"negativeCacheDuration": string
} |
| Campi |
matches[] |
object (ThreatMatch)
Gli hash completi che corrispondevano ai prefissi richiesti.
|
minimumWaitDuration |
string (Duration format)
La durata minima che il client deve attendere prima di inviare una richiesta di Trova hash. Se questo campo non viene impostato, i clienti possono inviare una richiesta non appena lo desiderano. Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
|
negativeCacheDuration |
string (Duration format)
Per le entità richieste che non corrispondevano all'elenco delle minacce, per quanto tempo memorizzare la risposta nella cache. Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
|
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\u003eThis API finds full hashes that match requested hash prefixes using a POST request to \u003ccode\u003ehttps://safebrowsing.googleapis.com/v4/fullHashes:find\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes client metadata, client states, threat information, and API client details, structured according to the provided JSON schema.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides matching full hashes, minimum wait duration before the next request, and negative cache duration for non-matching entities, all formatted as described in the schema.\u003c/p\u003e\n"]]],["This document details the process for finding full hashes matching requested hash prefixes via the `fullHashes:find` API. A `POST` request to the specified URL includes a JSON request body with client metadata (`client`, `apiClient`), client states (`clientStates`), and threat information (`threatInfo`). The response, if successful, contains matched full hashes (`matches`), a minimum wait duration (`minimumWaitDuration`) before the next request, and a negative cache duration (`negativeCacheDuration`).\n"],null,["# Method: fullHashes.find\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FindFullHashesResponse.SCHEMA_REPRESENTATION)\n\nFinds the full hashes that match the requested hash prefixes.\n\n### HTTP request\n\n`POST https://safebrowsing.googleapis.com/v4/fullHashes:find`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"client\": { object (/safe-browsing/reference/rest/v4/ClientInfo) }, \"clientStates\": [ string ], \"threatInfo\": { object (/safe-browsing/reference/rest/v4/ThreatInfo) }, \"apiClient\": { object (/safe-browsing/reference/rest/v4/ClientInfo) } } ``` |\n\n| Fields ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `client` | `object (`[ClientInfo](/safe-browsing/reference/rest/v4/ClientInfo)`)` The client metadata. |\n| `clientStates[]` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The current client states for each of the client's local threat lists. A base64-encoded string. |\n| `threatInfo` | `object (`[ThreatInfo](/safe-browsing/reference/rest/v4/ThreatInfo)`)` The lists and hashes to be checked. |\n| `apiClient` | `object (`[ClientInfo](/safe-browsing/reference/rest/v4/ClientInfo)`)` Client metadata associated with callers of higher-level APIs built on top of the client's implementation. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"matches\": [ { object (/safe-browsing/reference/rest/v4/ThreatMatch) } ], \"minimumWaitDuration\": string, \"negativeCacheDuration\": string } ``` |\n\n| Fields ||\n|-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `matches[]` | `object (`[ThreatMatch](/safe-browsing/reference/rest/v4/ThreatMatch)`)` The full hashes that matched the requested prefixes. |\n| `minimumWaitDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` The minimum duration the client must wait before issuing any find hashes request. If this field is not set, clients can issue a request as soon as they want. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n| `negativeCacheDuration` | `string (`[Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration)` format)` For requested entities that did not match the threat list, how long to cache the response. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |"]]
