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 theo định nghĩa của 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

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 hơn 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.
desiredHashLength
(deprecated)

enum (HashLength)

Độ dài tiền tố hàm băm mong muốn 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ả tiền tố hàm băm có độ dài được 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ề giá trị chấp nhận được 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ì lỗi sẽ được trả về cho ứng dụng.

Cụ thể là đố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, ứng dụng sẽ được chia thành nhiều BatchGetHashListsRequest.
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)

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