Method: fullHashes.find
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Recherche les hachages complets qui correspondent aux préfixes de hachage demandés.
Requête HTTP
POST https://safebrowsing.googleapis.com/v4/fullHashes:find
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
{
"client": {
object (ClientInfo )
},
"clientStates": [
string
],
"threatInfo": {
object (ThreatInfo )
},
"apiClient": {
object (ClientInfo )
}
} |
Champs |
client |
object (ClientInfo )
Métadonnées du client.
|
clientStates[] |
string (bytes format)
États du client actuel pour chacune des listes de menaces locales du client. Chaîne encodée en base64.
|
threatInfo |
object (ThreatInfo )
Listes et hachages à vérifier.
|
apiClient |
object (ClientInfo )
Métadonnées client associées aux appelants d'API de niveau supérieur basées sur l'implémentation du client.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
Représentation JSON |
{
"matches": [
{
object (ThreatMatch )
}
],
"minimumWaitDuration": string,
"negativeCacheDuration": string
} |
Champs |
matches[] |
object (ThreatMatch )
Hachages complets correspondant aux préfixes demandés.
|
minimumWaitDuration |
string (Duration format)
Durée minimale d'attente du client avant d'émettre une requête de hachage de recherche. Si ce champ n'est pas défini, les clients peuvent émettre une requête dès qu'ils le souhaitent. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s ". Exemple : "3.5s"
|
negativeCacheDuration |
string (Duration format)
Pour les entités demandées qui ne correspondaient pas à la liste des menaces, durée de mise en cache de la réponse. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s ". Exemple : "3.5s"
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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\"`. |"]]