Method: hashLists.batchGet
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mendapatkan beberapa daftar hash sekaligus.
Klien biasanya perlu mendapatkan beberapa daftar hash. Penggunaan metode ini lebih disarankan daripada menggunakan metode Get reguler beberapa kali.
Ini adalah metode Get batch standar seperti yang ditentukan oleh https://google.aip.dev/231 dan metode HTTP-nya juga GET.
Permintaan HTTP
GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
| Parameter |
names[] |
string
Wajib. Nama daftar hash tertentu. Daftar ini MUNGKIN berupa daftar ancaman, atau mungkin Cache Global. Nama TIDAK BOLEH berisi duplikat; jika ada, klien akan mendapatkan error.
|
version[] |
string (bytes format)
Versi daftar hash yang sudah dimiliki klien. Jika ini adalah pertama kalinya klien mengambil daftar hash, kolom harus dibiarkan kosong. Jika tidak, klien harus menyediakan versi yang sebelumnya diterima dari server. Klien TIDAK BOLEH memanipulasi byte tersebut. Klien tidak perlu mengirim versi dalam urutan yang sama dengan nama daftar yang sesuai. Klien dapat mengirim lebih sedikit atau lebih banyak versi dalam permintaan daripada jumlah nama. Namun, klien TIDAK BOLEH mengirim beberapa versi yang sesuai dengan nama yang sama; jika melakukannya, klien akan mendapatkan error. Catatan historis: di API V4, ini disebut states; sekarang diganti namanya menjadi version untuk memperjelas. String berenkode base64.
|
sizeConstraints |
object (SizeConstraints)
Batasan ukuran pada setiap daftar. Jika dihilangkan, tidak ada batasan. Perhatikan bahwa ukuran di sini adalah per daftar, bukan digabungkan di semua daftar.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons yang berisi beberapa daftar hash.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"hashLists": [
{
object (HashList)
}
]
} |
| Kolom |
hashLists[] |
object (HashList)
Daftar hash dalam urutan yang sama dengan yang diberikan dalam permintaan.
|
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."],[],[],null,["# Method: hashLists.batchGet\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.BatchGetHashListsResponse.SCHEMA_REPRESENTATION)\n\nGet multiple hash lists at once.\n\nIt is very common for a client to need to get multiple hash lists. Using this method is preferred over using the regular Get method multiple times.\n\nThis is a standard batch Get method as defined by \u003chttps://google.aip.dev/231\u003e and the HTTP method is also GET.\n\n### HTTP request\n\n`GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `names[]` | `string` Required. The names of the particular hash lists. The list MAY be a threat list, or it may be the Global Cache. The names MUST NOT contain duplicates; if they did, the client will get an error. |\n| `version[]` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` The versions of the hash list that the client already has. If this is the first time the client is fetching the hash lists, the field should be left empty. Otherwise, the client should supply the versions previously received from the server. The client MUST NOT manipulate those bytes. The client need not send the versions in the same order as the corresponding list names. The client may send fewer or more versions in a request than there are names. However the client MUST NOT send multiple versions that correspond to the same name; if it did, the client will get an error. Historical note: 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 each list. If omitted, there are no constraints. Note that the sizes here are per-list, not aggregated across all lists. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response containing multiple 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/v5/hashList#HashList) } ] } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `hashLists[]` | `object (`[HashList](/safe-browsing/reference/rest/v5/hashList#HashList)`)` The hash lists in the same order given in the request. |"]]
