Method: hashList.get

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

Ini adalah metode Get standar seperti yang ditentukan oleh https://google.aip.dev/131 dan metode HTTP 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. Informasi ini dapat berupa daftar ancaman, atau 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 dikosongkan. Jika tidak, klien HARUS menyediakan 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

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.
sizeConstraints

object (SizeConstraints)

Batasan ukuran dalam daftar. Jika dihilangkan, berarti tidak ada batasan. Batasan direkomendasikan di semua perangkat yang memiliki daya pemrosesan, bandwidth, atau penyimpanan terbatas.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi instance HashList.