Halaman ini diterjemahkan oleh Cloud Translation API.

Package google.security.safebrowsing.v5alpha1

Indeks

SafeBrowsing

Safe Browsing API memungkinkan klien memeriksa resource web (paling sering URL) berdasarkan daftar resource web tidak aman yang terus diperbarui Google.

BatchGetHashLists

BatchGetHashLists
`rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)` 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.

rpc BatchGetHashLists(BatchGetHashListsRequest) returns (BatchGetHashListsResponse)

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.

GetHashList

GetHashList
`rpc GetHashList(GetHashListRequest) returns (HashList)` 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.

rpc GetHashList(GetHashListRequest) returns (HashList)

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.

ListHashLists

ListHashLists
`rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)` Mencantumkan daftar hash. Di V5 API, Google tidak akan pernah menghapus daftar hash yang pernah ditampilkan oleh metode ini. Hal ini memungkinkan klien untuk melewati metode ini dan melakukan hard code semua daftar hash yang mereka butuhkan. Ini adalah metode Daftar standar seperti yang ditentukan oleh https://google.aip.dev/132 dan metode HTTP-nya adalah GET.

rpc ListHashLists(ListHashListsRequest) returns (ListHashListsResponse)

Mencantumkan daftar hash.

Di V5 API, Google tidak akan pernah menghapus daftar hash yang pernah ditampilkan oleh metode ini. Hal ini memungkinkan klien untuk melewati metode ini dan melakukan hard code semua daftar hash yang mereka butuhkan.

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

SearchHashes

SearchHashes
`rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)` Menelusuri hash lengkap yang cocok dengan awalan yang ditentukan. Ini adalah metode khusus seperti yang didefinisikan oleh https://google.aip.dev/136 (metode khusus ini merujuk pada metode ini yang memiliki nama khusus dalam nomenklatur pengembangan API umum Google; metode ini tidak merujuk pada penggunaan metode HTTP khusus).

rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse)

Menelusuri hash lengkap yang cocok dengan awalan yang ditentukan.

Ini adalah metode khusus seperti yang didefinisikan oleh https://google.aip.dev/136 (metode khusus ini merujuk pada metode ini yang memiliki nama khusus dalam nomenklatur pengembangan API umum Google; metode ini tidak merujuk pada penggunaan metode HTTP khusus).

BatchGetHashListsRequest

Permintaan untuk mendapatkan beberapa daftar hash secara bersamaan.

Kolom
`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[]`	`bytes` 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.
`desired_hash_length`	`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 `desired_hash_length` yang dapat diterima. Ini dapat ditemukan di kolom `supported_hash_lengths` di `HashListMetadata`. Jika `desired_hash_length` tidak menentukan nilai dalam `supported_hash_lengths`, error akan ditampilkan ke klien. Khususnya untuk `BatchGetHashListsRequest`, tidak mungkin bagi klien untuk menentukan `desired_hash_length` yang berbeda untuk daftar yang berbeda. Jika perlu, klien harus dibagi menjadi beberapa `BatchGetHashListsRequest`.
`size_constraints`	`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.

BatchGetHashListsResponse

Respons yang berisi beberapa daftar hash.

Kolom

Kolom
`hash_lists[]`	`HashList` Daftar hash dalam urutan yang sama seperti yang diberikan dalam permintaan.

hash_lists[]

HashList

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

FullHash

Hash lengkap diidentifikasi dengan satu atau beberapa kecocokan.

Kolom

Kolom
`full_hash`	`bytes` Hash lengkap yang cocok. Ini adalah hash SHA256. Panjangnya tepat adalah 32 byte.
`full_hash_details[]`	`FullHashDetail` Daftar yang tidak diurutkan. Kolom berulang yang mengidentifikasi detail yang relevan dengan hash lengkap ini.

full_hash

bytes

Hash lengkap yang cocok. Ini adalah hash SHA256. Panjangnya tepat adalah 32 byte.

full_hash_details[]

FullHashDetail

Daftar yang tidak diurutkan. Kolom berulang yang mengidentifikasi detail yang relevan dengan hash lengkap ini.

FullHashDetail

Detail tentang hash lengkap yang cocok.

Catatan penting tentang kompatibilitas dengan versi baru: jenis ancaman dan atribut ancaman baru dapat ditambahkan oleh server kapan saja; penambahan tersebut dianggap sebagai perubahan versi minor. Merupakan kebijakan Google untuk tidak mengekspos nomor versi minor dalam API (lihat https://cloud.google.com/apis/design/versioning untuk kebijakan pembuatan versi), sehingga klien HARUS siap menerima pesan FullHashDetail yang berisi nilai enum ThreatType atau nilai enum ThreatAttribute yang dianggap tidak valid oleh klien. Oleh karena itu, klien bertanggung jawab untuk memeriksa validitas semua nilai enum ThreatType dan ThreatAttribute; jika ada nilai yang dianggap tidak valid, klien HARUS mengabaikan seluruh pesan FullHashDetail.

Kolom

Kolom
`threat_type`	`ThreatType` Jenis ancaman. Kolom ini tidak akan pernah kosong.
`attributes[]`	`ThreatAttribute` Daftar yang tidak diurutkan. Atribut tambahan tentang hash lengkap tersebut. Kolom ini mungkin kosong.

threat_type

ThreatType

Jenis ancaman. Kolom ini tidak akan pernah kosong.

attributes[]

ThreatAttribute

Daftar yang tidak diurutkan. Atribut tambahan tentang hash lengkap tersebut. Kolom ini mungkin kosong.

GetHashListRequest

Permintaan untuk mendapatkan daftar hash, yang dapat berupa daftar ancaman atau daftar non-ancaman seperti Global Cache.

Yang baru di V5: Yang sebelumnya disebut states di V4 diganti namanya menjadi version agar lebih jelas. Daftar kini diberi nama, jenis platform dan jenis entri ancaman dihapus. Sekarang beberapa daftar dapat memiliki jenis ancaman yang sama, atau satu daftar yang berkaitan dengan beberapa jenis ancaman. Klien memiliki kemampuan baru untuk menentukan panjang hash yang diinginkan. Ini adalah bagian dari jawaban untuk awalan hash panjang variabel V4 yang telah menyebabkan masalah dalam banyak implementasi klien: semua hash dalam daftar sekarang memiliki satu panjang, sehingga memungkinkan implementasi klien yang jauh lebih efisien. Batasan telah disederhanakan, dan jenis kompresi dihapus (kompresi selalu diterapkan).

Kolom
`name`	`string` Wajib. Nama daftar hash khusus ini. Informasi ini dapat berupa daftar ancaman, atau Cache Global.
`version`	`bytes` 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.
`desired_hash_length`	`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 `desired_hash_length` yang dapat diterima. Ini dapat ditemukan di kolom `supported_hash_lengths` di `HashListMetadata`. Jika `desired_hash_length` tidak menentukan nilai dalam `supported_hash_lengths`, error akan ditampilkan.
`size_constraints`	`SizeConstraints` Batasan ukuran dalam daftar. Jika dihilangkan, berarti tidak ada batasan. Batasan direkomendasikan di semua perangkat yang memiliki daya pemrosesan, bandwidth, atau penyimpanan terbatas.

HashList

Daftar hash yang diidentifikasi berdasarkan namanya.

Kolom
`name`	`string` Nama daftar hash. Perhatikan bahwa {i>Global Cache<i} juga hanyalah daftar {i>hash<i} dan dapat dirujuk ke sini.
`version`	`bytes` Versi daftar hash. Klien TIDAK BOLEH memanipulasi byte tersebut.
`partial_update`	`bool` Jika benar, ini adalah perbedaan parsial yang berisi penambahan dan penghapusan berdasarkan apa yang sudah dimiliki klien. Jika salah (false), ini adalah daftar hash lengkap. Jika salah (false), klien HARUS menghapus versi yang disimpan secara lokal untuk daftar hash ini. Artinya, versi yang dimiliki klien sudah sangat usang atau data klien diyakini rusak. Kolom `compressed_removals` akan kosong. Jika benar, klien HARUS menerapkan update inkremental dengan menerapkan penghapusan, lalu penambahan.
`compressed_removals`	`RiceDeltaEncoded32Bit` Versi indeks penghapusan yang dienkode Rice-delta. Karena setiap daftar hash pasti memiliki kurang dari 2^32 entri, indeks diperlakukan sebagai bilangan bulat 32-bit dan dienkode.
`minimum_wait_duration`	`Duration` Klien harus menunggu setidaknya selama ini untuk mendapatkan daftar hash lagi. Jika dihilangkan atau nol, klien HARUS segera mengambil karena menunjukkan bahwa server memiliki update tambahan yang akan dikirim ke klien, tetapi tidak bisa karena batasan yang ditentukan klien.
`metadata`	`HashListMetadata` Metadata tentang daftar hash. Kolom ini tidak diisi oleh metode `GetHashList`, tetapi diisi oleh metode `ListHashLists`.
Kolom union `compressed_additions`. Versi penambahan yang dienkode Rice-delta. Panjang awalan hash pada penambahan seragam di semua penambahan dalam daftar. Kolom ini dapat berupa `desired_hash_length` yang dikirim oleh klien atau nilai yang dipilih oleh server jika klien menghilangkan kolom tersebut. `compressed_additions` hanya dapat berupa salah satu dari yang berikut:
`additions_four_bytes`	`RiceDeltaEncoded32Bit` Penambahan 4 byte.
`additions_eight_bytes`	`RiceDeltaEncoded64Bit` Penambahan 8 byte.
`additions_sixteen_bytes`	`RiceDeltaEncoded128Bit` Penambahan 16 byte.
`additions_thirty_two_bytes`	`RiceDeltaEncoded256Bit` Penambahan 32 byte.
Kolom union `checksum`. Ini adalah checksum untuk daftar semua hash yang diurutkan yang ada dalam database setelah menerapkan update yang disediakan. Ini adalah kolom "salah satu" yang memungkinkan beberapa algoritma hashing. Server juga dapat menghilangkan kolom ini (jika tidak ada update yang diberikan) untuk menunjukkan bahwa klien harus menggunakan checksum yang ada. `checksum` hanya ada berupa salah satu diantara berikut:
`sha256_checksum`	`bytes` Daftar semua hash yang diurutkan, di-hash lagi dengan SHA256.

HashListMetadata

Metadata tentang daftar hash tertentu.

Kolom
`threat_types[]`	`ThreatType` Daftar yang tidak diurutkan. Jika tidak kosong, kolom ini akan menentukan bahwa daftar hash adalah jenis daftar ancaman, dan ini akan menguraikan jenis ancaman yang terkait dengan hash atau awalan hash dalam daftar hash ini. Mungkin kosong jika entri tidak mewakili ancaman, yaitu jika entri mewakili jenis yang kemungkinan aman.
`likely_safe_types[]`	`LikelySafeType` Daftar yang tidak diurutkan. Jika tidak kosong, hal ini menentukan bahwa daftar hash mewakili daftar hash yang mungkin aman, dan menguraikan cara hash tersebut dianggap aman. Kolom ini sama-sama bersifat eksklusif dengan kolom ancaman_types.
`mobile_optimized`	`bool` Apakah daftar ini dioptimalkan untuk perangkat seluler (Android dan iOS).
`description`	`string` Deskripsi yang dapat dibaca manusia tentang daftar ini. Ditulis dalam bahasa Inggris.
`supported_hash_lengths[]`	`HashLength` Panjang hash yang didukung untuk daftar hash ini. Setiap daftar {i>hash<i} akan mendukung setidaknya satu panjang. Oleh karena itu, kolom ini tidak akan kosong.

HashLength

Panjang hash dalam daftar hash.

Enum
`HASH_LENGTH_UNSPECIFIED`	Panjang tidak ditentukan. Server tidak akan menampilkan nilai ini sebagai respons terhadap klien (di kolom `supported_hash_lengths`), tetapi klien diizinkan untuk mengirim nilai ini ke server (di kolom `desired_hash_length`), dalam hal ini server akan memilih nilai secara otomatis. Klien HARUS membiarkan server memilih nilai.
`FOUR_BYTES`	Setiap hash adalah prefiks empat byte.
`EIGHT_BYTES`	Setiap {i>hash<i} adalah awalan delapan byte.
`SIXTEEN_BYTES`	Setiap {i>hash<i} adalah awalan enam belas byte.
`THIRTY_TWO_BYTES`	Setiap {i>hash<i} adalah {i>hash<i} penuh tiga puluh dua byte.

LikelySafeType

Jenis situs yang kemungkinan aman.

Perhatikan bahwa SearchHashesResponse sengaja tidak berisi LikelySafeType.

Enum
`LIKELY_SAFE_TYPE_UNSPECIFIED`	Tidak diketahui.
`GENERAL_BROWSING`	Situs ini mungkin cukup aman untuk penjelajahan umum. Dikenal juga sebagai cache global.
`CSD`	Situs ini mungkin cukup aman sehingga Anda tidak perlu menjalankan model Deteksi Sisi Klien atau pemeriksaan perlindungan sandi.
`DOWNLOAD`	Situs ini mungkin cukup aman sehingga download dari situs ini tidak perlu diperiksa.

ListHashListsRequest

Permintaan untuk menampilkan daftar hash yang tersedia.

Kolom

Kolom
`page_size`	`int32` Jumlah maksimum daftar hash untuk ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, server akan memilih ukuran halaman, yang mungkin lebih besar dari jumlah daftar hash sehingga penomoran halaman tidak diperlukan.
`page_token`	`string` Token halaman, diterima dari panggilan `ListHashLists` sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

page_size

int32

Jumlah maksimum daftar hash untuk ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, server akan memilih ukuran halaman, yang mungkin lebih besar dari jumlah daftar hash sehingga penomoran halaman tidak diperlukan.

page_token

string

Token halaman, diterima dari panggilan ListHashLists sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

ListHashListsResponse

Respons yang berisi metadata tentang daftar hash.

Kolom

Kolom
`hash_lists[]`	`HashList` Daftar {i>hash<i} dalam urutan arbitrer. Hanya metadata tentang daftar hash yang akan disertakan, bukan kontennya.
`next_page_token`	`string` Token, yang dapat dikirim sebagai `page_token` untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

hash_lists[]

HashList

Daftar {i>hash<i} dalam urutan arbitrer. Hanya metadata tentang daftar hash yang akan disertakan, bukan kontennya.

next_page_token

string

Token, yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

RiceDeltaEncoded128Bit

Sama seperti RiceDeltaEncoded32Bit, tetapi ini mengenkode angka 128-bit.

Kolom
`first_value_hi`	`uint64` 64 bit atas dari entri pertama dalam data yang dienkode (hash). Jika {i>field<i} kosong, 64 bit atas semuanya adalah nol.
`first_value_lo`	`fixed64` 64 bit lebih rendah dari entri pertama dalam data yang dienkode (hash). Jika {i>field<i}-nya kosong, 64 bit yang lebih rendah adalah nol.
`rice_parameter`	`int32` Parameter Golomb-Rice. Parameter ini dijamin antara 99 dan 126, inklusif.
`entries_count`	`int32` Jumlah entri yang dienkode secara delta dalam data yang dienkode. Jika hanya satu bilangan bulat yang dienkode, nilainya akan menjadi nol dan nilai tunggal akan disimpan di `first_value`.
`encoded_data`	`bytes` Delta yang dienkode yang dienkode menggunakan pembuat kode Golomb-Rice.

RiceDeltaEncoded256Bit

Sama seperti RiceDeltaEncoded32Bit, tetapi ini mengenkode angka 256-bit.

Kolom
`first_value_first_part`	`uint64` 64 bit pertama dari entri pertama dalam data yang dienkode (hash). Jika {i>field<i} tersebut kosong, 64 bit pertama adalah nol.
`first_value_second_part`	`fixed64` Bit ke-65 hingga 128 dari entri pertama dalam data yang dienkode (hash). Jika {i>field<i} tersebut kosong, maka 65 sampai 128 bit semuanya adalah nol.
`first_value_third_part`	`fixed64` Bit 129 sampai 192 dari entri pertama dalam data yang dienkode (hash). Jika isian kosong, angka 129 sampai 192 bit adalah nol.
`first_value_fourth_part`	`fixed64` 64 bit terakhir dari entri pertama dalam data yang dienkode (hash). Jika {i>field<i} kosong, 64 bit terakhir adalah nol.
`rice_parameter`	`int32` Parameter Golomb-Rice. Parameter ini dijamin antara 227 dan 254, inklusif.
`entries_count`	`int32` Jumlah entri yang dienkode secara delta dalam data yang dienkode. Jika hanya satu bilangan bulat yang dienkode, nilainya akan menjadi nol dan nilai tunggal akan disimpan di `first_value`.
`encoded_data`	`bytes` Delta yang dienkode yang dienkode menggunakan pembuat kode Golomb-Rice.

RiceDeltaEncoded32Bit

Data yang dienkode Rice-Golomb. Digunakan untuk hash atau indeks penghapusan. Dijamin bahwa setiap {i>hash<i} atau indeks di sini memiliki panjang yang sama, dan panjangnya tepat 32 bit.

Secara umum, jika kita mengurutkan semua entri secara leksikografis, kita akan menemukan bahwa bit urutan yang lebih tinggi cenderung tidak berubah sesering bit urutan yang lebih rendah. Ini berarti bahwa jika kita juga mengambil selisih antara entri yang berdekatan, bit urutan yang lebih tinggi memiliki probabilitas tinggi untuk menjadi nol. Hal ini mengeksploitasi probabilitas nol yang tinggi ini dengan pada dasarnya memilih sejumlah bit tertentu; semua bit lebih signifikan daripada ini cenderung nol sehingga kita menggunakan pengkodean unary. Lihat kolom rice_parameter.

Catatan historis: Encoding Rice-delta pertama kali digunakan di V4 pada API ini. Pada V5, dua peningkatan signifikan dilakukan: pertama, pengkodean Rice-delta sekarang tersedia dengan awalan hash yang lebih panjang dari 4 byte; kedua, data yang dienkode sekarang diperlakukan sebagai big-endian untuk menghindari langkah pengurutan yang mahal.

Kolom
`first_value`	`uint32` Entri pertama dalam data yang dienkode (hash atau indeks), atau, jika hanya ada satu awalan atau indeks hash yang dienkode, adalah nilai entri tersebut. Jika kolom kosong, entrinya adalah nol.
`rice_parameter`	`int32` Parameter Golomb-Rice. Parameter ini dijamin antara 3 dan 30, inklusif.
`entries_count`	`int32` Jumlah entri yang dienkode secara delta dalam data yang dienkode. Jika hanya satu bilangan bulat yang dienkode, nilainya akan menjadi nol dan nilai tunggal akan disimpan di `first_value`.
`encoded_data`	`bytes` Delta yang dienkode yang dienkode menggunakan pembuat kode Golomb-Rice.

RiceDeltaEncoded64Bit

Sama seperti RiceDeltaEncoded32Bit, tetapi ini mengenkode angka 64-bit.

Kolom
`first_value`	`uint64` Entri pertama dalam data yang dienkode (hash), atau, jika hanya satu awalan hash yang dienkode, nilai entri tersebut. Jika kolom kosong, entrinya adalah nol.
`rice_parameter`	`int32` Parameter Golomb-Rice. Parameter ini dijamin antara 35 dan 62, inklusif.
`entries_count`	`int32` Jumlah entri yang dienkode secara delta dalam data yang dienkode. Jika hanya satu bilangan bulat yang dienkode, nilainya akan menjadi nol dan nilai tunggal akan disimpan di `first_value`.
`encoded_data`	`bytes` Delta yang dienkode yang dienkode menggunakan pembuat kode Golomb-Rice.

SearchHashesRequest

Permintaan yang dikeluarkan klien untuk menelusuri awalan hash tertentu.

Fitur ini dirancang untuk hanya menelusuri daftar ancaman, dan tidak menelusuri daftar non-ancaman seperti Global Cache.

Yang baru di V5: Klien tidak perlu menentukan ClientInfo atau status daftar hash di database lokal mereka. Hal ini dilakukan untuk meningkatkan privasi. Selain itu, klien tidak perlu mengirimkan jenis ancaman yang mereka minati.

Kolom

Kolom
`hash_prefixes[]`	`bytes` Wajib. Awalan hash yang akan dicari. Klien TIDAK BOLEH mengirim lebih dari 1.000 awalan hash. Namun, dengan mengikuti prosedur pemrosesan URL, klien TIDAK BOLEH mengirim lebih dari 30 awalan hash. Saat ini, setiap awalan hash harus tepat 4 byte. Kebijakan ini MUNGKIN santai di masa mendatang.
`filter`	`string` Opsional. Jika klien ingin melakukan pemfilteran, seperti hanya mengambil jenis ancaman tertentu, parameter ini dapat ditentukan. Jika dihilangkan, semua ancaman yang cocok akan ditampilkan. Sebaiknya hapus opsi ini untuk mendapatkan perlindungan paling lengkap yang dapat ditawarkan oleh Safe Browsing. Filter ditentukan menggunakan Google Common Expression Language, yang dapat ditemukan di https://github.com/google/cel-spec beserta contoh umum. Berikut beberapa contoh spesifik yang dapat digunakan di sini: Filter `"threat_type == ThreatType.SOCIAL_ENGINEERING"` mengharuskan jenis ancaman dalam `FullHashDetail` harus `SOCIAL_ENGINEERING`. ID `"threat_type"` mengacu pada jenis ancaman saat ini. ID `"ThreatType"` mengacu pada kumpulan semua kemungkinan jenis ancaman. Filter `"threat_type in [ ThreatType.UNWANTED_SOFTWARE, ThreatType.MALWARE ]"` mengharuskan jenis ancaman harus `UNWANTED_SOFTWARE` atau `MALWARE`.

hash_prefixes[]

bytes

Wajib. Awalan hash yang akan dicari. Klien TIDAK BOLEH mengirim lebih dari 1.000 awalan hash. Namun, dengan mengikuti prosedur pemrosesan URL, klien TIDAK BOLEH mengirim lebih dari 30 awalan hash.

Saat ini, setiap awalan hash harus tepat 4 byte. Kebijakan ini MUNGKIN santai di masa mendatang.

filter

string

Opsional. Jika klien ingin melakukan pemfilteran, seperti hanya mengambil jenis ancaman tertentu, parameter ini dapat ditentukan. Jika dihilangkan, semua ancaman yang cocok akan ditampilkan. Sebaiknya hapus opsi ini untuk mendapatkan perlindungan paling lengkap yang dapat ditawarkan oleh Safe Browsing.

Filter ditentukan menggunakan Google Common Expression Language, yang dapat ditemukan di https://github.com/google/cel-spec beserta contoh umum. Berikut beberapa contoh spesifik yang dapat digunakan di sini:

Filter "threat_type == ThreatType.SOCIAL_ENGINEERING" mengharuskan jenis ancaman dalam FullHashDetail harus SOCIAL_ENGINEERING. ID "threat_type" mengacu pada jenis ancaman saat ini. ID "ThreatType" mengacu pada kumpulan semua kemungkinan jenis ancaman.

Filter "threat_type in [ ThreatType.UNWANTED_SOFTWARE, ThreatType.MALWARE ]" mengharuskan jenis ancaman harus UNWANTED_SOFTWARE atau MALWARE.

SearchHashesResponse

Respons yang ditampilkan setelah menelusuri hash ancaman.

Jika tidak ada yang ditemukan, server akan menampilkan status Oke (kode status HTTP 200) dengan kolom full_hashes kosong, bukan menampilkan status NOT_FOUND (kode status HTTP 404).

Yang baru di V5: Ada pemisahan antara FullHash dan FullHashDetail. Jika hash mewakili situs yang memiliki beberapa ancaman (mis. MALWARE dan SOCIAL_EngineERING), hash lengkapnya tidak perlu dikirim dua kali seperti di V4. Selain itu, durasi cache telah disederhanakan menjadi satu kolom cache_duration.

Kolom

Kolom
`full_hashes[]`	`FullHash` Daftar yang tidak diurutkan. Daftar hash lengkap yang tidak diurutkan ditemukan.
`cache_duration`	`Duration` Durasi cache sisi klien. Klien HARUS menambahkan durasi ini ke waktu saat ini untuk menentukan waktu habis masa berlaku. Kemudian, waktu habis masa berlaku akan berlaku untuk setiap awalan hash yang dikueri oleh klien dalam permintaan, terlepas dari jumlah hash lengkap yang ditampilkan dalam respons. Meskipun server tidak menampilkan hash lengkap untuk awalan hash tertentu, fakta ini HARUS juga di-cache oleh klien. Jika dan hanya jika kolom `full_hashes` kosong, klien MUNGKIN meningkatkan `cache_duration` untuk menentukan masa berlaku baru yang lebih lambat dari yang ditentukan oleh server. Namun, peningkatan durasi cache tidak boleh lebih dari 24 jam. Penting: klien TIDAK BOLEH berasumsi bahwa server akan mengembalikan durasi cache yang sama untuk semua respons. Server MUNGKIN memilih durasi cache yang berbeda untuk respons yang berbeda bergantung pada situasi.

full_hashes[]

FullHash

Daftar yang tidak diurutkan. Daftar hash lengkap yang tidak diurutkan ditemukan.

cache_duration

Duration

Durasi cache sisi klien. Klien HARUS menambahkan durasi ini ke waktu saat ini untuk menentukan waktu habis masa berlaku. Kemudian, waktu habis masa berlaku akan berlaku untuk setiap awalan hash yang dikueri oleh klien dalam permintaan, terlepas dari jumlah hash lengkap yang ditampilkan dalam respons. Meskipun server tidak menampilkan hash lengkap untuk awalan hash tertentu, fakta ini HARUS juga di-cache oleh klien.

Jika dan hanya jika kolom full_hashes kosong, klien MUNGKIN meningkatkan cache_duration untuk menentukan masa berlaku baru yang lebih lambat dari yang ditentukan oleh server. Namun, peningkatan durasi cache tidak boleh lebih dari 24 jam.

Penting: klien TIDAK BOLEH berasumsi bahwa server akan mengembalikan durasi cache yang sama untuk semua respons. Server MUNGKIN memilih durasi cache yang berbeda untuk respons yang berbeda bergantung pada situasi.

SizeConstraints

Batasan pada ukuran daftar hash.

Kolom

Kolom
`max_update_entries`	`int32` Ukuran maksimum dalam jumlah entri. Update tidak akan berisi lebih banyak entri dari nilai ini, tetapi update tersebut mungkin akan berisi entri yang lebih sedikit dari nilai ini. Nilai ini minimal HARUS 1024. Jika dihilangkan atau nol, tidak ada batas ukuran update yang ditetapkan.
`max_database_entries`	`int32` Menetapkan jumlah entri maksimum yang ingin dimiliki klien dalam database lokal untuk daftar. (Server MUNGKIN menyebabkan klien menyimpan kurang dari jumlah entri ini.) Jika dihilangkan atau nol, tidak ada batas ukuran database yang ditetapkan.

max_update_entries

int32

Ukuran maksimum dalam jumlah entri. Update tidak akan berisi lebih banyak entri dari nilai ini, tetapi update tersebut mungkin akan berisi entri yang lebih sedikit dari nilai ini. Nilai ini minimal HARUS 1024. Jika dihilangkan atau nol, tidak ada batas ukuran update yang ditetapkan.

max_database_entries

int32

Menetapkan jumlah entri maksimum yang ingin dimiliki klien dalam database lokal untuk daftar. (Server MUNGKIN menyebabkan klien menyimpan kurang dari jumlah entri ini.) Jika dihilangkan atau nol, tidak ada batas ukuran database yang ditetapkan.

ThreatAttribute

Atribut ancaman. Atribut ini dapat memberikan arti tambahan pada ancaman tertentu, tetapi tidak akan memengaruhi jenis ancaman tersebut. Misalnya, atribut dapat menentukan tingkat keyakinan yang lebih rendah, sedangkan atribut lain mungkin menentukan tingkat keyakinan yang lebih tinggi. Atribut lainnya dapat ditambahkan di masa mendatang.

Enum
`THREAT_ATTRIBUTE_UNSPECIFIED`	Atribut tidak diketahui. Jika ini ditampilkan oleh server, klien harus mengabaikan `FullHashDetail` yang disertakan.
`CANARY`	Menunjukkan bahwa ancaman_type tidak boleh digunakan untuk penegakan.
`FRAME_ONLY`	Menunjukkan bahwa ancaman_type hanya boleh digunakan untuk penerapan pada frame.

ThreatType

Jenis ancaman.

Enum
`THREAT_TYPE_UNSPECIFIED`	Jenis ancaman tidak diketahui. Jika ini ditampilkan oleh server, klien harus mengabaikan `FullHashDetail` yang disertakan.
`MALWARE`	Jenis ancaman malware. Malware adalah software atau aplikasi seluler yang dirancang khusus untuk merusak komputer, perangkat seluler, software yang dijalankannya, atau penggunanya. Malware menunjukkan perilaku berbahaya yang dapat meliputi penginstalan software tanpa izin dari pengguna dan penginstalan software berbahaya seperti virus. Informasi selengkapnya dapat ditemukan di sini.
`SOCIAL_ENGINEERING`	Jenis ancaman manipulasi psikologis. Halaman manipulasi psikologis palsu berpura-pura bertindak atas nama pihak ketiga dengan maksud membingungkan penonton sehingga melakukan tindakan yang membuat penonton hanya memercayai agen sejati dari pihak ketiga tersebut. {i>Phishing<i} adalah jenis manipulasi psikologis yang mengelabui penonton agar melakukan tindakan tertentu dalam memberikan informasi, seperti kredensial login. Informasi selengkapnya dapat ditemukan di sini.
`UNWANTED_SOFTWARE`	Jenis ancaman software yang tidak diinginkan. Software yang tidak diinginkan adalah software yang tidak mematuhi Prinsip Software Google, tetapi bukan malware.
`POTENTIALLY_HARMFUL_APPLICATION`	Jenis ancaman aplikasi yang berpotensi berbahaya seperti yang digunakan oleh Google Play Protect untuk Play Store.