Method: hashLists.batchGet

Nhận nhiều danh sách băm cùng một lúc.

Rất thường xuyên, ứng dụng cần nhận 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 Lấy hàng loạt chuẩn do https://google.aip.dev/231 xác định và phương thức HTTP cũng là GET.

Yêu cầu HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashLists:batchGet

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
names[]

string

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 toàn cầu. Tên KHÔNG ĐƯỢC chứa tên trùng lặp; nếu có, ứng dụng khách sẽ gặp lỗi.
version[]

string (bytes format)

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ì trường này phải để trống. 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úng các byte đó.

Ứng dụng không cần gửi các phiên bản theo thứ tự giống 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 trong một yêu cầu so với số lượng tên. Tuy nhiên, ứng dụng 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, ứng dụng sẽ gặp lỗi.

Lưu ý về quá khứ: trong API phiên bản 4, thuộc tính này được gọi là states; hiện được đổi tên thành version để rõ ràng hơn.

Chuỗi được mã hoá base64.
sizeConstraints

object (SizeConstraints)

Giới hạn về kích thước trên mỗi danh sách. Nếu bạn bỏ qua, thì sẽ không có quy tắc ràng buộc nào. Xin lưu ý rằng kích thước ở đây là theo 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 (HashList)
    }
  ]
}
Trường
hashLists[]

object (HashList)

Các danh sách băm theo thứ tự được đưa ra trong yêu cầu.