Method: hashLists.batchGet

Mendapatkan beberapa daftar hash sekaligus.

Sangat umum bagi klien untuk mendapatkan beberapa daftar hash. Menggunakan 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 juga GET.

Permintaan HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
names[]

string

Wajib diisi. Nama-nama daftar hash tertentu. Daftar tersebut mungkin berupa daftar ancaman, atau mungkin Cache Global. Nama TIDAK BOLEH berisi duplikat; jika ya, maka klien akan mendapatkan pesan {i>error.<i}

version[]

string (bytes format)

Versi daftar hash yang telah 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 seperti nama daftar yang sesuai. Klien mungkin 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 pesan {i>error.<i}

Catatan historis: di API V4, hal ini disebut states; sekarang namanya diganti 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-beda pada nilai kolom desiredHashLength yang dapat diterima. Kolom ini dapat ditemukan di kolom supportedHashLengths di HashListMetadata. Jika desiredHashLength tidak menentukan nilai dalam supportedHashLengths, error akan ditampilkan ke klien.

Khususnya untuk BatchGetHashListsRequest, klien tidak dapat menentukan desiredHashLength yang berbeda untuk daftar yang berbeda. Jika perlu melakukannya, klien harus dibagi menjadi beberapa BatchGetHashListsRequest.

sizeConstraints

object (SizeConstraints)

Batasan ukuran pada setiap daftar. Jika dihilangkan, 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 dengan yang diberikan dalam permintaan.