名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
mailSearchFolder は、指定された検索条件に一致するすべての電子メール アイテムを含む、ユーザーのメールボックス内の仮想フォルダーです。 mailSearchFolder は mailFolder から継承します。 検索フォルダーは、ユーザーの Exchange Online メールボックス内の任意のフォルダーに作成できます。 ただし、Outlook、Outlook for the web、または Outlook Live で検索フォルダーを表示するには、WellKnownFolderName.SearchFolders フォルダーにフォルダーを作成する必要があります。
検索フォルダーのライフサイクル
Exchange Online は、次のいずれかの理由でアプリケーションによって作成された検索フォルダーを削除する可能性があります。
- 検索フォルダーは、45 日間使用されないと期限切れになります。
- ソース フォルダーごとに作成できる検索フォルダーの数には制限があります。 この制限を破ると、古い検索フォルダーが削除され、新しい検索フォルダーに取って代わられます。
検索フォルダーが削除された場合、アプリは新しい検索フォルダー リソースを作成してそれを使用する必要があります。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| Create | mailSearchFolder | このユーザーのメールボックスに検索フォルダーを作成します。 |
| Get | mailSearchFolder | 指定した検索フォルダーを取得します。 |
| Update | mailSearchFolder | 指定した検索フォルダーを更新します。 |
| Delete | なし | 指定した検索フォルダーを削除します。 |
| 完全に削除 | なし | メール検索フォルダを完全に削除し、そのアイテムをユーザーのメールボックスから削除します。 |
| 子フォルダーを一覧表示する | mailFolder コレクション | 検索フォルダーを含む、このユーザーのメールボックス内のすべてのフォルダーを一覧表示します。 |
| フォルダー内のメッセージを一覧表示する | message コレクション | 指定した検索フォルダー内のすべてのメッセージを一覧表示する。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| isSupported | ブール型 | 検索フォルダーが REST API を使用して編集できるかどうかを示します。 |
| includeNestedFolders | ブール型 | 検索でメールボックス フォルダー階層を走査する方法を示します。
true
sourceFolderIds で明示的に指定された各フォルダーの階層に子フォルダーを含めるには、詳細検索を実行する必要があることを意味します。
false
sourceFolderIds で明示的に指定された各フォルダーのみの浅い検索を意味します。 |
| sourceFolderIds | String collection | マイニングする必要があるメールボックス フォルダー。 |
| filterQuery | 文字列 | メッセージをフィルター処理する OData クエリ。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"isSupported": true,
"includeNestedFolders": true,
"sourceFolderIds": ["string"],
"filterQuery": "string"
}