Method: urls.search

Tìm kiếm các URL trùng khớp với các mối đe doạ đã biết. Mỗi URL và biểu thức hậu tố máy chủ lưu trữ cũng như tiền tố đường dẫn (tối đa ở một độ sâu giới hạn) đều được kiểm tra. Điều này có nghĩa là phản hồi có thể chứa những URL không có trong yêu cầu, nhưng là biểu thức của các URL được yêu cầu.

Yêu cầu HTTP

GET https://safebrowsing.googleapis.com/v5alpha1/urls:search

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

Tham số truy vấn

Thông số
urls[]

string

Bắt buộc. URL cần tìm. Ứng dụng KHÔNG ĐƯỢC gửi quá 50 URL.

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 trả về sau khi tìm kiếm các mối đe doạ trùng khớp với URL được chỉ định.

Nếu không tìm thấy nội dung nào, máy chủ sẽ trả về trạng thái OK (mã trạng thái HTTP 200) với trường threats trống thay vì trả về trạng thái NOT_FOUND (mã trạng thái HTTP 404).

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 
{
  "threats": [
    {
      object (ThreatUrl)
    }
  ],
  "cacheDuration": string
}
Trường
threats[]

object (ThreatUrl)

Danh sách không theo thứ tự. Danh sách không có thứ tự gồm các kết quả trùng khớp với mối đe doạ được tìm thấy. Mỗi mục nhập chứa một URL và các loại mối đe doạ được phát hiện trùng khớp với URL đó. Kích thước danh sách có thể lớn hơn số lượng URL trong yêu cầu vì tất cả biểu thức của URL sẽ được xem xét.
cacheDuration

string (Duration format)

Thời lượng bộ nhớ đệm phía máy khách. Ứng dụng phải thêm khoảng thời gian này vào thời gian hiện tại để xác định thời gian hết hạn. Sau đó, thời gian hết hạn sẽ áp dụng cho mọi URL mà ứng dụng khách truy vấn trong yêu cầu, bất kể có bao nhiêu URL được trả về trong phản hồi. Ngay cả khi máy chủ không trả về kết quả trùng khớp cho một URL cụ thể, thì máy khách CŨNG PHẢI lưu trữ thông tin này vào bộ nhớ đệm.

Nếu và chỉ khi trường threats trống, thì ứng dụng CÓ THỂ tăng cacheDuration để xác định thời gian hết hạn mới muộn hơn thời gian do máy chủ chỉ định. Trong mọi trường hợp, thời gian lưu vào bộ nhớ đệm tăng lên không được dài hơn 24 giờ.

Quan trọng: ứng dụng KHÔNG ĐƯỢC giả định rằng máy chủ sẽ trả về cùng một khoảng thời gian lưu vào bộ nhớ đệm cho tất cả các phản hồi. Máy chủ CÓ THỂ chọn thời lượng lưu vào bộ nhớ đệm khác nhau cho các phản hồi khác nhau tuỳ thuộc vào tình huống.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

ThreatUrl

Một URL khớp với một hoặc nhiều mối đe doạ.

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "threatTypes": [
    enum (ThreatType)
  ]
}
Trường
url

string

URL được yêu cầu đã được so khớp với một hoặc nhiều mối đe doạ.
threatTypes[]

enum (ThreatType)

Danh sách không theo thứ tự. Danh sách mối đe doạ không theo thứ tự mà URL được phân loại.