Method: hashLists.batchGet

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/v5alpha1/hashLists:batchGet

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
names[]

string

Wajib. Nama daftar hash tertentu. Daftar ini MUNGKIN merupakan 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.
desiredHashLength
(deprecated)

enum (HashLength)

Panjang awalan hash yang diinginkan dari hash yang ditampilkan dalam byte. Kemudian, server akan menampilkan semua awalan hash dalam panjang yang ditentukan ini.

Daftar hash yang berbeda memiliki persyaratan yang berbeda pada nilai kolom desiredHashLength yang dapat diterima. Ini dapat ditemukan di kolom supportedHashLengths di HashListMetadata. Jika desiredHashLength tidak menentukan nilai dalam supportedHashLengths, error akan ditampilkan kepada klien.

Khusus 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, 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.