Query filters

Gunakan spesifikasi filter kueri di bawah ini pada permintaan API yang memberikan kemampuan pemfilteran. String filter harus ditetapkan sebagai ekspresi atau daftar ekspresi.

Ekspresi sederhana

Filter harus ditentukan menggunakan tata bahasa berikut:

Ekspresi memiliki bentuk umum:

<expr> ::= <field> <operator> <value>

  • <field> adalah string. Jika <field> berisi spasi atau titik dua harus dikurung dengan tanda kutip ganda.
  • <operator> dapat berupa operator kesetaraan atau relasional, dan mengikuti spesifikasi seperti di bawah:
    Operator kesetaraan "=" hanya ditentukan untuk kolom string.
    Operator pencocokan awalan ":" hanya ditentukan untuk kolom string.
    Operator relasional "<" | ">" | "<=" | ">=" hanya ditentukan untuk kolom stempel waktu.
  • <value> yang diberikan harus string yang mungkin dalam format Timestamp bergantung pada <field>. Jika <value> berisi spasi atau titik dua, keduanya harus diapit dalam tanda kutip ganda.

Daftar ekspresi

Ekspresi dapat digabungkan untuk membentuk kueri yang lebih kompleks. Spesifikasi BNF adalah:

<exprList> ::= <expr> |
<exprList> <conjunction> <expr> |
<negation> <expr>
<conjunction> ::= "AND" | "OR" | ""
<negation> ::= "NOT"
Menggunakan string kosong sebagai konjungsi bertindak sebagai AND implisit.
Prioritas operasi penggabungan, dari tertinggi hingga terendah, adalah NOT, AND, OR.

Contoh

Di bawah ini adalah beberapa contoh filter. Perhatikan bahwa kolom sebenarnya yang didukung dapat bervariasi di antara berbagai versi API. Untuk kolom filter yang tersedia di v1beta1, lihat di sini.

Untuk membuat kueri semua notifikasi yang dibuat pada atau setelah 5 April 2018:
createTime >= "2018-04-05T00:00:00Z"

Untuk membuat kueri semua notifikasi dari sumber "phishing Gmail":
source="Gmail phishing"

Untuk mengkueri semua notifikasi dari sumber yang dimulai dengan "Gmail":
source:"Gmail"

Untuk membuat kueri semua notifikasi yang dimulai pada tahun 2017:
startTime >= "2017-01-01T00:00:00Z" AND startTime < "2018-01-01T00:00:00Z"

Untuk membuat kueri untuk semua notifikasi phishing yang dilaporkan pengguna dari sumber "Gmail type="User reported phishing" source="Gmail phishing"":
startTime >= "2017-01-01T00:00:00Z" AND startTime < "2018-01-01T00:00:00Z"

Untuk mengkueri semua notifikasi phishing yang dilaporkan pengguna dari sumber tersebut:
"Gmail type="User reported phishing" source="Gmail phishing"