Method: hashList.get

Mendapatkan konten terbaru dari daftar hash. Daftar hash dapat berupa daftar ancaman atau daftar non-ancaman seperti Cache Global.

Ini adalah metode Get standar seperti yang ditentukan oleh https://google.aip.dev/131 dan metode HTTP-nya juga GET.

Permintaan HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama daftar hash khusus ini. Daftar tersebut dapat berupa daftar ancaman, atau dapat berupa Cache Global.

Parameter kueri

Parameter
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 memberikan versi yang sebelumnya diterima dari server. Klien TIDAK BOLEH memanipulasi byte tersebut.

Yang baru di V5: di V4 API, ini disebut states; sekarang diganti namanya menjadi version agar lebih jelas.

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.

sizeConstraints

object (SizeConstraints)

Batasan ukuran pada daftar. Jika dihilangkan, tidak ada batasan. Batasan direkomendasikan di semua perangkat dengan daya pemrosesan, bandwidth, atau penyimpanan terbatas.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat instance HashList.