REST Resource: users.settings.filters

Resource: Filter

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

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

string

Server yang menetapkan ID filter.
criteria

object (Criteria)

Kriteria pencocokan untuk filter.
action

object (Action)

Tindakan yang dijalankan filter.

Kriteria

Kriteria pencocokan 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 dalam "kepada", "cc", dan "bcc" {i>header<i}. Anda hanya dapat menggunakan bagian lokal dari alamat email. Misalnya, "example" dan "example@" keduanya cocok dengan "example@gmail.com". Kolom ini tidak peka huruf besar/kecil.
subject

string

Frasa yang tidak peka huruf besar/kecil ditemukan dalam subjek pesan. Spasi kosong yang memulai dan akhir akan dipangkas dan spasi yang berdekatan diciutkan.
query

string

Hanya tampilkan 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 tampilkan 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 atau tidak.
excludeChats

boolean

Apakah respons harus mengecualikan chat.
size

integer

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

enum (SizeComparison)

Seharusnya ukuran pesan dalam byte dibandingkan dengan kolom ukuran.

SizeComparison

Menentukan cara membandingkan kolom ukuran dan ukuran pesan.

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

Tindakan

Serangkaian tindakan yang harus dilakukan pada pesan.

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

string

Daftar label untuk ditambahkan ke pesan.
removeLabelIds[]

string

Daftar label yang akan dihapus dari pesan.
forward

string

Alamat email yang menjadi tujuan penerusan pesan.

Metode

create

 Membuat filter.

delete

 Menghapus filter yang ditentukan dengan segera dan permanen.

get

 Mendapatkan filter.

list

 Mencantumkan filter pesan pengguna Gmail.