Method: fullHashes.find
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menemukan hash lengkap yang cocok dengan awalan hash yang diminta.
Permintaan HTTP
POST https://safebrowsing.googleapis.com/v4/fullHashes:find
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
{
"client": {
object (ClientInfo)
},
"clientStates": [
string
],
"threatInfo": {
object (ThreatInfo)
},
"apiClient": {
object (ClientInfo)
}
} |
| Kolom |
client |
object (ClientInfo)
Metadata klien.
|
clientStates[] |
string (bytes format)
Status klien saat ini untuk setiap daftar ancaman lokal klien. String berenkode base64.
|
threatInfo |
object (ThreatInfo)
Daftar dan hash yang akan diperiksa.
|
apiClient |
object (ClientInfo)
Metadata klien yang terkait dengan pemanggil API tingkat lebih tinggi yang dibangun berdasarkan implementasi klien.
|
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"matches": [
{
object (ThreatMatch)
}
],
"minimumWaitDuration": string,
"negativeCacheDuration": string
} |
| Kolom |
matches[] |
object (ThreatMatch)
Hash lengkap yang cocok dengan awalan yang diminta.
|
minimumWaitDuration |
string (Duration format)
Durasi minimum yang harus ditunggu klien sebelum mengeluarkan permintaan hash temukan apa pun. Jika kolom ini tidak disetel, klien dapat mengeluarkan permintaan sesegera mungkin. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
|
negativeCacheDuration |
string (Duration format)
Untuk entitas yang diminta yang tidak cocok dengan daftar ancaman, berapa lama respons akan di-cache. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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\"`. |"]]
