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

受信者の表示名またはメールアドレス。[to]、[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

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

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

アクション

メッセージに対して実行する一連のアクション。

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

string

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

string

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

string

メールを転送するメールアドレス。

メソッド

create

 フィルタを作成します。

delete

 指定されたフィルタを即座に完全に削除します。

get

 フィルタを取得します。

list

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