Method: hashList.get

Lấy nội dung mới nhất của danh sách băm. Danh sách băm có thể là danh sách mối đe doạ hoặc danh sách không phải mối đe doạ, chẳng hạn như Bộ nhớ đệm toàn cục.

Đây là phương thức Get chuẩn do https://google.aip.dev/131 xác định và phương thức HTTP cũng là GET.

Yêu cầu HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/hashList/{name}

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

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên của danh sách hàm băm cụ thể này. Đó có thể là danh sách mối đe doạ hoặc có thể là Bộ nhớ đệm toàn cầu.

Tham số truy vấn

Thông số
version

string (bytes format)

Phiên bản 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 PHẢI cung cấp 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 đó.

Tính năng mới trong phiên bản 5: trong phiên bản 4 của API, 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ì hệ thống sẽ trả về lỗi.
sizeConstraints

object (SizeConstraints)

Các quy tắc ràng buộc về kích thước đối với danh sách. Nếu bạn bỏ qua, thì sẽ không có quy tắc ràng buộc nào. Bạn nên áp dụng các quy tắc ràng buộc trên tất cả thiết bị có hạn chế về sức mạnh xử lý, băng thông hoặc bộ nhớ.

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

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của HashList.