Method: hashLists.batchGet

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[]

string

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[]

string (bytes format)

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 states; sekarang diganti namanya menjadi version agar lebih jelas.

String berenkode base64.
desiredHashLength

enum (HashLength)

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 desiredHashLength yang dapat diterima. Ini dapat ditemukan di kolom supportedHashLengths di HashListMetadata. Jika desiredHashLength tidak menentukan nilai dalam supportedHashLengths, error akan ditampilkan ke klien.

Khususnya untuk BatchGetHashListsRequest, tidak mungkin bagi klien untuk menentukan desiredHashLength yang berbeda untuk daftar yang berbeda. Jika perlu, klien harus dibagi menjadi beberapa BatchGetHashListsRequest.
sizeConstraints

object (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 (HashList)
    }
  ]
}
Kolom
hashLists[]

object (HashList)

Daftar hash dalam urutan yang sama seperti yang diberikan dalam permintaan.