Search Emails（メールの検索）

1つまたは複数のメールを検索します。詳細については、Gmailのドキュメントを参照してください。

スコープ

このカードで必要なOAuthスコープのリストは「アクションカード」を参照してください。

フィールド	定義	タイプ	必須
Result Set（結果セット）	次の中から選択します。［First matching email（最初の一致メール）］：検索条件を満たす最初のメールメッセージを返します［All matching emails（すべての一致メール）］：検索条件を満たすすべてのメールメッセージを返します	ドロップダウン	TRUE

フィールド

定義

タイプ

必須

Result Set（結果セット）

次の中から選択します。

ドロップダウン

TRUE

フィールド	定義	タイプ	必須
Query（クエリ）	指定されたクエリに一致するメッセージのみを返します。 Gmail検索ボックスと同じクエリ形式に対応します。例：from:someuser@example.com rfc822msgid:somemsgid@example.com is:unread。「Search operators you can use with Gmail（Gmail で使用できる検索演算子）」を参照してください。	テキスト	FALSE
With Labels（付帯ラベル）	メッセージフィルタリングに含めるラベル（［Important（重要）］、［Starred（スター付き）］、または［Spam（スパム）］など）。	リスト	FALSE
Include Spam and Trash（スパムとゴミ箱を含める）	スパムおよびゴミ箱のメッセージを含めるにはTrue に設定し、それらを除外するにはFalse に設定します。	True/False	FALSE

フィールド

定義

タイプ

必須

Query（クエリ）

指定されたクエリに一致するメッセージのみを返します。

Gmail検索ボックスと同じクエリ形式に対応します。例：from:someuser@example.com rfc822msgid:somemsgid@example.com is:unread。

「Search operators you can use with Gmail（Gmail で使用できる検索演算子）」を参照してください。

テキスト

FALSE

With Labels（付帯ラベル）

メッセージフィルタリングに含めるラベル（［Important（重要）］、［Starred（スター付き）］、または［Spam（スパム）］など）。

リスト

FALSE

Include Spam and Trash（スパムとゴミ箱を含める）

スパムおよびゴミ箱のメッセージを含めるにはTrue に設定し、それらを除外するにはFalse に設定します。

True/False

FALSE

フィールド	定義	タイプ
Emails（メール）	検索で返されたメールオブジェクトのリストで、各オブジェクトは［First Matching Email（最初の一致メール）］セクションで説明しているフィールドを含みます。	リスト
Message ID（メッセージID）	メッセージの一意のID。	テキスト
Subject（件名）	メッセージの件名。	テキスト
Text Body（テキスト本文）	メッセージの本文中のテキスト。	テキスト
HTML Body（HTML本文）	メッセージのHTML書式の本文。	テキスト
To（宛先）	メッセージ受信者のメールアドレス（書式は複数のアドレスを個別メールのリストに含めるか、カンマまたはセミコロンで区切られた単一のテキスト文字列です）。	テキスト
From（送信元）	メッセージの送信者。	テキスト
CC（カーボンコピー）	カーボンコピー受信者のリスト。	リスト
Attachment IDs（添付ファイルID）	メール添付ファイルの一意のIDのリスト。	オブジェクトのリスト
Labels（ラベル）	メッセージが属するカテゴリーのリスト（［Unread］、［Important］など）。	リスト