Zoho Mailの検索構文
Zoho Mailには、メールボックスを広範囲にわたって検索し、目的のメールを検索または取得するための複数のオプションが用意されています。検索操作は、さまざまなパラメーターを組み合わせて実行できます。REST APIを介してZoho Mailを使用するか、Zoho Mailと外部サービスの連携機能を使用してメールを検索するには、文字列の値を検索キーとして作成して使用する必要があります。検索結果が期待どおりに返されるようにするには、検索キーを特定の構文に組み込む必要があります。さまざまなパラメーター、演算子、使用可能なパラメーターの値について、以下に説明してください。
次の表は、一致する結果を得るために検索語を渡すことができるさまざまなパラメーターを示しています。検索語は、パラメーター:<検索値>の形式の次のパラメーターを指定して渡すことができます。
| パラメーター | 説明 |
| entire | 指定した単語がメールの任意の場所に含まれる結果を返します。 |
| sender | 完全なメールアドレスが指定されている場合は、特定の送信者からのメールを返します。 検索語が（メールアドレスではなく）単語の場合、その単語が送信元アドレスのユーザー名の部分またはドメインの部分に含まれるメールが検索結果に返されます。 |
| to | 指定したメールアドレスがメールの［宛先］欄に含まれるメールが返されます。 検索語が単語の場合、その単語が宛先アドレスのユーザー名の部分またはドメインの部分に含まれるメールが返されます。 |
| cc | パラメーター「to」と同じ |
| subject | 指定した単語がメールの件名に含まれるメールを返します。 |
| fileName | 指定した単語が添付ファイル名の一部として含まれるメールを返します。 |
| fileContent | 指定したテキストが添付ファイルの内容に含まれるメールを返します。 |
完全一致の検索テキストを二重引用符で囲み、語句として検索できます。
例：
1. entire:Hello::entire:world
この検索文字列は、内容の任意の場所に「Hello」と「World」の単語を含むメールを返します。単語は同じ順序である必要はありません。
2. entire:"Hello world"
この検索文字列は、引用符で囲んだものと同じように、メール内に「Hello World」という正確な語句を含むメールを返します。
その他の検索条件：
上記の検索語に加えて、フォルダー、ラベル、添付ファイル、フラグ、メールの種類、メールの送信日時などの追加の検索条件を指定できます。
| パラメーター | 使用可能な値 | 例 |
| has | hasパラメーターを使用すると、メールの結果をさらに絞り込むことができます。 | has:attachment - 添付ファイル付きメール has:flags - フラグ付きメール has:convo - スレッドの一部であるメール |
| in | このパラメーターを含めると、特定のフォルダー内を検索できます。 in:<フォルダー名> | in:Marketing 「Marketing」はフォルダーの名前です。 |
| label | このパラメーターを含めると、特定のタグ/ラベルが含まれるメールを検索できます。 in:<ラベル名> | label:payroll 「payroll」はラベルの名前です。 |
fromDate toDate | fromDate、toDateパラメーターは、日付範囲を指定してメールの送信者を指定できます。 fromDate:DD-MMM-YYYY | fromDate:12-Sep-2017 |
| inclspamtrash | 検索を実行する際に、［迷惑メール］フォルダーと［ごみ箱］フォルダーからの結果も必要な場合は、このパラメーターを含めてください。 inclspamtrash:true | inclspamtrash:true |
演算子：
複数のパラメーターを検索に含める場合、::演算子とOR演算子を使用して、さまざまなパラメーターを組み合わせることができます。
検索テキスト/値をパラメーターに渡すには、コロン（:）を使用してください。
たとえば、「marketing」という語を含むメールを検索する場合は、「entire:marketing」と記述する必要があります。
次の条件を指定するための演算子：
1つの検索キーで一連の条件を指定する場合は、::を使用して次の条件を指定する必要があります。
構文 - ::
例 - entire:payroll::has:attachment
この検索キーは、添付ファイルとメールの一部に「payroll」の語が含まれるメールを返します。
OR演算子：
構文 - :or:
例 - sender:frank@zylker.com::or:to:frank@zylker.com
この検索キーでは、frank@zylker.comから送受信されるメールが一覧表示されます。
注：
::演算子の後に演算子が指定されていない場合、AND演算が初期設定で実行されます。
検索キーの例：
subject:Bill::sender:customercare@creditcard.com::has:attachment
検索キーとして渡された上記の文字列の値は、件名に「Bill」の語が含まれ、送信者が「customercare@creditcard.com」で、添付ファイル付きのメールを返します。