mailSearchFolder 资源类型

命名空间：microsoft.graph

mailSearchFolder 是用户邮箱中的虚拟文件夹，其中包含与指定搜索条件匹配的所有电子邮件项目。 mailSearchFolder 继承自 mailFolder。 可以在用户Exchange Online邮箱中的任何文件夹中创建搜索文件夹。 但是，若要在 Outlook、Outlook 网页版 或 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	字符串集合	应挖掘的邮箱文件夹。

JSON 表示形式

下面是资源的 JSON 表示形式。

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