REST Resource: users.settings.filters

リソース: Filter

Gmail フィルタのリソース定義。フィルタはメールスレッド全体ではなく、特定のメールに適用されます。

JSON 表現
{
  "id": string,
  "criteria": {
    object (Criteria)
  },
  "action": {
    object (Action)
  }
}
フィールド
id

string

サーバーが割り当てたフィルタの ID。

criteria

object (Criteria)

フィルタの一致条件。

action

object (Action)

フィルタで実行されるアクション。

条件

メールが条件に一致します。

JSON 表現
{
  "from": string,
  "to": string,
  "subject": string,
  "query": string,
  "negatedQuery": string,
  "hasAttachment": boolean,
  "excludeChats": boolean,
  "size": integer,
  "sizeComparison": enum (SizeComparison)
}
フィールド
from

string

送信者の表示名またはメールアドレス。

to

string

受信者の表示名またはメールアドレス。[宛先]、[Cc]、[Bcc] に受信者も含める使用します。メールアドレスのローカル部分のみを使用できます。例: "example"および「example@」どちらも「example@gmail.com」と一致します。このフィールドでは、大文字と小文字は区別されません。

subject

string

メールの件名に含まれる、大文字と小文字を区別しないフレーズ。末尾と先頭の空白文字は削除され、隣接するスペースは非表示になります。

query

string

指定したクエリに一致するメッセージのみを返します。Gmail の検索ボックスと同じクエリ形式をサポートします。たとえば、"from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread" です。

negatedQuery

string

指定したクエリに一致しないメッセージのみを返します。Gmail の検索ボックスと同じクエリ形式をサポートします。たとえば、"from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread" です。

hasAttachment

boolean

メッセージに添付ファイルがあるかどうか。

excludeChats

boolean

レスポンスでチャットを除外するかどうか。

size

integer

すべてのヘッダーと添付ファイルを含む、RFC822 メッセージ全体のサイズ(バイト単位)。

sizeComparison

enum (SizeComparison)

サイズ フィールドに対するメッセージ サイズ(バイト単位)。

SizeComparison

サイズ フィールドとメッセージ サイズの比較方法を指定します。

列挙型
unspecified
smaller 指定したサイズより小さいメールを検索します。
larger 指定したサイズより大きいメールを検索します。

アクション

メールに対して行う一連の操作。

JSON 表現
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "forward": string
}
フィールド
addLabelIds[]

string

メッセージに追加するラベルのリスト。

removeLabelIds[]

string

メールから削除するラベルのリストです。

forward

string

メッセージの転送先のメールアドレス。

メソッド

create

フィルタを作成します。

delete

指定したフィルタを直ちに完全に削除します。

get

フィルタを取得します。

list

Gmail ユーザーのメッセージ フィルタを一覧表示します。