次の方法で共有


mailSearchFolder リソースの種類

名前空間: microsoft.graph

mailSearchFolder は、指定した検索条件に一致するすべてのメール アイテムを含む、ユーザーのメールボックス内の仮想フォルダーです。 mailSearchFolder は mailFolder から継承します。 検索フォルダーは、ユーザーの Exchange Online メールボックス内の任意のフォルダーに作成できます。 ただし、Outlook、Outlook for the web、または Outlook Live に検索フォルダーを表示するには、 フォルダーを WellKnownFolderName.SearchFolders フォルダーに作成する必要があります。

検索フォルダーのライフサイクル

アプリケーションによって作成された検索フォルダーは、次のいずれかの理由で Exchange Online によって削除できます。

  1. 検索フォルダーは、45 日間使用しなかった後に有効期限が切れます。
  2. ソース フォルダーごとに作成できる検索フォルダーの数には制限があります。 この制限に違反すると、古い検索フォルダーが削除され、新しい検索フォルダーが作成されます。

検索フォルダーが削除されると、アプリで新しい検索フォルダー リソースを作成し、同じリソースを使用する必要があります。

メソッド

メソッド 戻り値の型 説明
メール検索フォルダーを作成する mailSearchFolder このユーザーのメールボックスに検索フォルダーを作成します。
子フォルダーを一覧表示する mailFolder コレクション 検索フォルダーを含め、このユーザーのメールボックス内のすべてのフォルダーを一覧表示します。
メール検索フォルダーを取得する mailSearchFolder 指定した検索フォルダーを取得します。
メール検索フォルダーを更新する mailSearchFolder 指定した検索フォルダーを更新します。
メール検索フォルダーを削除する なし 指定した検索フォルダーを削除します。
フォルダー内のメッセージを一覧表示する message コレクション 指定した検索フォルダー内のすべてのメッセージを一覧表示します。

プロパティ

プロパティ 説明
filterQuery String メッセージをフィルター処理する OData クエリ。
includeNestedFolders ブール型 検索でメールボックス フォルダー階層を走査する方法を示します。 true は、 sourceFolderIds で明示的に指定された各フォルダーの階層に子フォルダーを含めるために、ディープ検索を実行する必要があることを意味します。 false は、sourceFolderIds で明示的に指定された各フォルダーの浅い検索のみを意味します。
isSupported ブール型 検索フォルダーが REST API を使用して編集可能かどうかを示します。
sourceFolderIds String collection 採掘するメールボックス フォルダー。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}