Query filters

Gunakan spesifikasi filter kueri di bawah dalam permintaan API yang memberikan kemampuan pemfilteran. String filter harus ditentukan 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 diapit tanda kutip ganda.
  • <operator> dapat berupa operator kesetaraan atau relasional, dan mengikuti spesifikasi seperti di bawah ini:
    Operator persamaan "=" hanya ditentukan untuk kolom string.
    Operator kecocokan awalan ":" hanya ditentukan untuk kolom string.
    Operator relasional "<" | ">" | "<=" | ">=" hanya ditentukan untuk kolom stempel waktu.
  • <value> yang disediakan harus berupa string yang mungkin menggunakan format Timestamp, bergantung pada <field>. Jika <value> berisi spasi atau titik dua, tanda kutip tersebut harus diapit dalam tanda kutip ganda.

Daftar ekspresi

Anda dapat menggabungkan ekspresi untuk membuat 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 untuk menggabungkan operasi, dari yang tertinggi ke terendah, BUKAN, DAN, ATAU.

Contoh

Berikut ini beberapa contoh filter. Perhatikan bahwa kolom aktual yang didukung dapat bervariasi antara versi API yang berbeda. 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 membuat kueri semua notifikasi dari sumber yang dimulai dengan "Gmail":
source:"Gmail"

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

Untuk melaporkan semua notifikasi yang berasal dari phishing