Obsługiwane pola filtra zapytań

Informacje o składni filtra znajdziesz w artykule Filtry zapytań, a przykłady filtrów – poniżej.

Pola obsługiwane przez alerts.list

Filtrowanie pól
alertId

Należy go używać do filtrowania alertów na podstawie ich identyfikatorów.

Odpowiednia wartość powinna być typu string.

type

Należy go używać do filtrowania alertów według typu.

Odpowiadająca wartość powinna być typu string. Możliwe wartości tego filtra są wymienione w opisie pola Alert.type.

source

Powinien służyć do filtrowania alertów na podstawie źródła alertu.

Odpowiadająca wartość powinna być typu string. Możliwe wartości tego filtra są wymienione w opisie pola Alert.type.

createTime

Należy go używać do filtrowania alertów na podstawie czasu ich utworzenia.

Odpowiednia wartość powinna być typu string (Timestamp format); a dokładniej powinna być ciągiem znaków zdefiniowanym w RFC 3339, na przykład "2018-01-01T00:00:00Z".

startTime

Należy go używać do filtrowania alertów na podstawie czasu rozpoczęcia alertu.

Odpowiednia wartość powinna być typu string (Timestamp format); a dokładniej powinna być to ciąg znaków z datą i czasem zgodny z RFC 3339, na przykład "2018-01-01T00:00:00Z".

endTime

Należy go używać do filtrowania alertów na podstawie czasu ich zakończenia.

Odpowiednia wartość powinna być typu string (Timestamp format); a dokładniej powinna być ciągiem znaków daty i godziny zgodnym z RFC 3339, na przykład "2018-01-01T00:00:00Z".

Przykłady zapytań dotyczących list

  • Aby wyszukać wszystkie alerty utworzone 5 kwietnia 2018 r. lub później:
    createTime >= "2018-04-05T00:00:00Z"
  • Aby wyszukać wszystkie alerty z źródła „Wyłudzanie informacji w Gmailu”:
    source:"Gmail phishing"
  • Aby wyszukać wszystkie alerty, które zaczęły się w 2017 r.:
    startTime >= "2017-01-01T00:00:00Z&" AND startTime < "2018-01-01T00:00:00Z"
  • Aby wyszukać wszystkie zgłoszone przez użytkowników alerty dotyczące prób wyłudzenia informacji z źródła „Gmail phishing”:
    type:"User reported phishing" source:"Gmail phishing"

Pola obsługiwane przez alerts.feedback.list

Filtrowanie pól
alertId

Należy go używać do filtrowania opinii o alertach na podstawie identyfikatora alertu.

Odpowiadająca wartość powinna być typu string. Można go używać do wyświetlania opinii dotyczących wybranych alertów w jednym wywołaniu, gdy w żądaniu alertId jest używany symbol wieloznaczny „-”.

feedbackId

Należy go używać do filtrowania opinii o alertach na podstawie identyfikatora opinii.

Odpowiadająca wartość powinna być typu string.

Przykłady zapytań dotyczących listy opinii

  • Aby zapytać o opinie dotyczące alertów o identyfikatorach alertId01 lub alertId02:
    alertId = alertId01 OR alertId = alertId02
  • Aby zapytać o opinię dotyczącą alertu alertId01 o identyfikatorze feedbackId01:
    alertId = alertId01 AND feedbackId = feedbackId01