Method: hashLists.batchGet

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

Việc khách hàng cần có nhiều danh sách băm là điều rất phổ biến. Phương thức này được ưu tiên hơn việc 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 thông thường 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

Tham số
names[]

string

Bắt buộc. Tên của danh sách băm cụ thể. Danh sách này CÓ THỂ là một 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[]

string (bytes format)

Các phiên bản của danh sách băm mà ứng dụng đã có. Nếu đây là lần đầu tiên ứng dụng tìm nạp danh sách băm, bạn nên để trống trường này. Nếu không, ứng dụng 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 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 ý trước đây: trong phiên bản 4 của API, API này được gọi là states; giờ đây, API này được đổi tên thành version để cho rõ ràng hơn.

Một chuỗi được mã hoá base64.
desiredHashLength

enum (HashLength)

Độ dài tiền tố hàm băm mong muốn của hàm băm được trả về tính bằng byte. Sau đó, máy chủ sẽ trả về tất cả các tiền tố băm trong độ dài đã chỉ định này.

Các danh sách băm khác nhau có các yêu cầu khác nhau về các giá trị được chấp nhận của trường desiredHashLength. Bạn có thể tìm thấy thông tin này ở trường supportedHashLengths trên HashListMetadata. Nếu desiredHashLength không chỉ định giá trị trong supportedHashLengths, hệ thống sẽ trả về lỗi cho ứng dụng.

Cụ thể, đối với BatchGetHashListsRequest, ứng dụng không thể chỉ định một desiredHashLength khác cho các danh sách khác nhau. Nếu cần thực hiện việc đó, ứng dụng nên chia thành nhiều BatchGetHashListsRequest.
sizeConstraints

object (SizeConstraints)

Các giới hạn về kích thước trong mỗi danh sách. Nếu bỏ qua thì sẽ không có hạn chế nào. Xin lưu ý rằng kích thước ở đây là theo từng danh sách, không được tổng hợp trên tất cả cá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 hàm 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)

Danh sách hàm băm theo cùng thứ tự nêu trong yêu cầu.