REST Resource: users.settings.filters

Resource: Filter

Definisi resource untuk filter Gmail. Filter berlaku untuk pesan tertentu, bukan seluruh rangkaian email.

Representasi JSON 
{
  "id": string,
  "criteria": {
    object (Criteria)
  },
  "action": {
    object (Action)
  }
}
Kolom
id

string

ID filter yang ditetapkan oleh server.
criteria

object (Criteria)

Kriteria pencocokan untuk filter.
action

object (Action)

Tindakan yang dilakukan filter.

Kriteria

Kriteria kecocokan pesan.

Representasi JSON 
{
  "from": string,
  "to": string,
  "subject": string,
  "query": string,
  "negatedQuery": string,
  "hasAttachment": boolean,
  "excludeChats": boolean,
  "size": integer,
  "sizeComparison": enum (SizeComparison)
}
Kolom
from

string

Nama tampilan atau alamat email pengirim.
to

string

Nama tampilan atau alamat email penerima. Menyertakan penerima di kolom header "hingga", "cc", dan "bcc". Anda dapat menggunakan bagian lokal alamat email saja. Misalnya, "example" dan "example@" cocok dengan "example@gmail.com". Kolom ini tidak peka huruf besar/kecil.
subject

string

Frasa tidak peka huruf besar/kecil yang ditemukan dalam subjek pesan. Spasi kosong di awal dan akhir akan dipangkas serta ruang yang berdekatan akan diciutkan.
query

string

Hanya menampilkan pesan yang cocok dengan kueri yang ditentukan. Mendukung format kueri yang sama dengan kotak penelusuran Gmail. Misalnya, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
negatedQuery

string

Hanya menampilkan pesan yang tidak cocok dengan kueri yang ditentukan. Mendukung format kueri yang sama dengan kotak penelusuran Gmail. Misalnya, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".
hasAttachment

boolean

Apakah pesan memiliki lampiran.
excludeChats

boolean

Apakah respons harus mengecualikan chat.
size

integer

Ukuran seluruh pesan RFC822 dalam byte, termasuk semua header dan lampiran.
sizeComparison

enum (SizeComparison)

Bagaimana ukuran pesan dalam byte harus dikaitkan dengan kolom ukuran.

Perbandingan Ukuran

Menentukan bagaimana kolom ukuran harus dibandingkan dengan ukuran pesan.

Enumerasi
unspecified
smaller Menemukan pesan yang lebih kecil dari ukuran yang ditentukan.
larger Menemukan pesan yang lebih besar dari ukuran yang ditentukan.

Tindakan

Sekumpulan tindakan yang harus dilakukan pada pesan.

Representasi JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "forward": string
}
Kolom
addLabelIds[]

string

Daftar label yang akan ditambahkan ke pesan.
removeLabelIds[]

string

Daftar label yang akan dihapus dari pesan.
forward

string

Alamat email yang akan dikirimi pesan.

Metode

create

 Membuat filter.

delete

 Segera dan secara permanen menghapus filter yang ditentukan.

get

 Mendapatkan filter.

list

 Mencantumkan filter pesan pengguna Gmail.