Các trường bộ lọc truy vấn được hỗ trợ

Hãy xem bài viết Bộ lọc truy vấn để tham khảo về cú pháp bộ lọc và xem các ví dụ về bộ lọc dưới đây.

Các trường do alerts.list hỗ trợ

Lọc các trường
alertId

Bạn nên dùng loại thông báo này để lọc cảnh báo dựa trên mã thông báo.

Giá trị tương ứng phải thuộc loại: string.

type

Bạn nên dùng loại thông báo này để lọc cảnh báo dựa trên loại thông báo.

Giá trị tương ứng phải thuộc loại: string. Các giá trị có thể có cho bộ lọc này được liệt kê trong nội dung mô tả trường Alert.type.

source

Bạn nên dùng loại thông báo này để lọc cảnh báo dựa trên nguồn cảnh báo.

Giá trị tương ứng phải thuộc loại: string. Các giá trị có thể có cho bộ lọc này được liệt kê trong nội dung mô tả trường Alert.type.

createTime

Bạn nên dùng loại thông báo này để lọc cảnh báo dựa trên thời gian tạo thông báo.

Giá trị tương ứng phải thuộc loại: string (Timestamp format); cụ thể hơn là chuỗi ngày giờ RFC 3339, ví dụ: "2018-01-01T00:00:00Z"

startTime

Bạn nên dùng loại thông báo này để lọc cảnh báo dựa trên thời gian bắt đầu thông báo.

Giá trị tương ứng phải thuộc loại: string (Timestamp format); cụ thể hơn là chuỗi ngày giờ RFC 3339, ví dụ: "2018-01-01T00:00:00Z"

endTime

Bạn nên dùng loại thông báo này để lọc cảnh báo dựa trên thời gian kết thúc cảnh báo.

Giá trị tương ứng phải thuộc loại: string (Timestamp format); cụ thể hơn là chuỗi ngày giờ RFC 3339, ví dụ: "2018-01-01T00:00:00Z"

Ví dụ về truy vấn danh sách

  • Để truy vấn tất cả thông báo được tạo vào hoặc sau ngày 5 tháng 4 năm 2018, hãy làm như sau:
    createTime >= "2018-04-05T00:00:00Z"
  • Cách truy vấn tất cả cảnh báo từ nguồn "Lừa đảo trên Gmail":
    source:"Gmail phishing"
  • Cách truy vấn tất cả các thông báo bắt đầu vào năm 2017:
    startTime >= "2017-01-01T00:00:00Z&" AND startTime < "2018-01-01T00:00:00Z"
  • Cách truy vấn tất cả cảnh báo lừa đảo do người dùng báo cáo từ nguồn "Lừa đảo trên Gmail":
    type:"User reported phishing" source:"Gmail phishing"

Các trường do alerts.feedback.list hỗ trợ

Lọc các trường
alertId

Bạn nên dùng loại thông báo này để lọc ý kiến phản hồi dựa trên mã thông báo.

Giá trị tương ứng phải thuộc loại: string. Có thể dùng để liệt kê ý kiến phản hồi về các cảnh báo đã chọn trong một lệnh gọi khi ký tự đại diện "-" được dùng trong alertId của yêu cầu.

feedbackId

Bạn nên dùng thuộc tính này để lọc ý kiến phản hồi về thông báo dựa trên mã phản hồi.

Giá trị tương ứng phải thuộc loại: string.

Ví dụ về truy vấn danh sách phản hồi

  • Cách truy vấn ý kiến phản hồi về các cảnh báo có mã alertId01 hoặc alertId02:
    alertId = alertId01 OR alertId = alertId02
  • Cách truy vấn ý kiến phản hồi về một thông báo alertId01 có mã phản hồi feedbackId01:
    alertId = alertId01 AND feedbackId = feedbackId01