Dapatkan beberapa daftar hash sekaligus.
Sangat umum bagi klien untuk perlu mendapatkan beberapa daftar {i>hash<i}. Menggunakan metode ini lebih disukai 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 juga GET.
Permintaan HTTP
GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
names[] |
Wajib. Nama-nama daftar {i>hash<i} tertentu. Daftar tersebut MUNGKIN berupa daftar ancaman, atau dapat berupa Cache Global. Nama TIDAK BOLEH berisi duplikat; jika ada, klien akan mendapatkan error. |
version[] |
Versi daftar hash yang sudah dimiliki klien. Jika ini adalah pertama kalinya klien mengambil daftar hash, kolom ini 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 nama. Namun, klien TIDAK BOLEH mengirim beberapa versi yang sesuai dengan nama yang sama; jika ya, klien akan mendapatkan error. Catatan historis: di V4 API, ini disebut String berenkode base64. |
desiredHashLength |
Panjang awalan hash yang diinginkan dari hash yang ditampilkan dalam byte. Server kemudian akan menampilkan semua awalan hash dalam panjang yang ditentukan ini. Daftar hash yang berbeda memiliki persyaratan yang berbeda untuk nilai kolom Khususnya untuk |
sizeConstraints |
Batasan ukuran di setiap daftar. Jika dihilangkan, berarti tidak ada batasan. Perhatikan bahwa ukuran di sini adalah per daftar, tidak 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 ( |
Kolom | |
---|---|
hashLists[] |
Daftar hash dalam urutan yang sama seperti yang diberikan dalam permintaan. |