Nhận nhiều danh sách băm cùng một lúc.
Khách hàng thường cần lấy nhiều danh sách băm. Bạn nên sử dụng phương thức này thay vì sử dụng phương thức Get thông thường nhiều lần.
Đây là phương thức Get theo lô tiêu chuẩn như được xác định theo https://google.aip.dev/231 và phương thức HTTP cũng là GET.
Yêu cầu HTTP
GET https://safebrowsing.googleapis.com/v5/hashLists:batchGet
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Tham số | |
|---|---|
names[] |
Bắt buộc. Tên của các danh sách băm cụ thể. Danh sách NÀY CÓ THỂ là danh sách mối đe doạ hoặc có thể là Bộ nhớ đệm chung. Tên KHÔNG ĐƯỢC chứa nội dung trùng lặp; nếu có, ứng dụng sẽ gặp lỗi. |
version[] |
Các phiên bản của danh sách băm mà ứng dụng khách đã có. Nếu đây là lần đầu tiên ứng dụng tìm nạp danh sách băm, thì bạn nên để trống trường này. Nếu không, ứng dụng khách phải cung cấp các phiên bản đã nhận được trước đó từ máy chủ. Ứng dụng KHÔNG ĐƯỢC thao tác với các byte đó. Ứng dụng không cần gửi các phiên bản theo cùng thứ tự với tên danh sách tương ứng. Ứng dụng có thể gửi ít hoặc nhiều phiên bản hơn trong một yêu cầu so với số lượng tên. Tuy nhiên, máy khách KHÔNG ĐƯỢC gửi nhiều phiên bản tương ứng với cùng một tên; nếu gửi, máy khách sẽ gặp lỗi. Lưu ý về lịch sử: trong API phiên bản 4, tham số này được gọi là Một chuỗi được mã hoá base64. |
sizeConstraints |
Giới hạn về kích thước của từng danh sách. Nếu bạn bỏ qua, thì sẽ không có điều kiện ràng buộc nào. Xin lưu ý rằng kích thước ở đây là theo từng danh sách, chứ không phải tổng hợp trên tất cả danh sách. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi chứa nhiều danh sách băm.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
|---|
{
"hashLists": [
{
object ( |
| Trường | |
|---|---|
hashLists[] |
Các danh sách băm theo cùng thứ tự được đưa ra trong yêu cầu. |