Method: hashLists.batchGet

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

Việc một khách hàng cần nhận nhiều danh sách băm là rất thường gặp. Việc sử dụng phương thức này được ưu tiên hơn so với việc sử dụng phương thức Get thông thường nhiều lần.

Đây là phương thức Get tiêu chuẩn theo lô 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/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 các danh sách băm cụ thể. Danh sách đó có thể là danh sách các 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ó thì ứng dụng sẽ báo 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 máy khách tìm nạp danh sách hàm băm, thì 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 hơn hoặc nhiều phiên bản trong một yêu cầu hơn so với số 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 có, ứng dụng sẽ nhận được thông báo lỗi.

Ghi chú trước đây: trong phiên bản 4 của API, mã này có tên là states; để cho rõ ràng hơn, nó hiện được đổi tên thành version.

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

enum (HashLength)

Độ dài tiền tố mong muốn cho hàm băm của các 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 có độ dài được chỉ định này.

Các danh sách băm khác nhau có yêu cầu khác nhau về 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 trong trường supportedHashLengths trong HashListMetadata. Nếu desiredHashLength không chỉ định giá trị trong supportedHashLengths thì ứng dụng sẽ trả về lỗi.

Cụ thể, đối với BatchGetHashListsRequest, khách hàng không thể chỉ định một desiredHashLength khác cho các danh sách khác nhau. Nếu cần làm 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 trên mỗi 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 được tính theo từng danh sách, không phải đượ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 có 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 hàm băm theo cùng thứ tự đã cung cấp trong yêu cầu.