mailSearchFolder 资源类型

命名空间：microsoft.graph

mailSearchFolder 是用户邮箱中的虚拟文件夹，其中包含符合指定搜索条件的所有电子邮件项目。 mailSearchFolder 继承自 mailFolder。 可以在用户邮箱的任何文件夹中创建搜索Exchange Online文件夹。 但是，若要在 Outlook、Outlook 或 Outlook Live 中显示搜索文件夹，必须在 WellKnownFolderName.SearchFolders 文件夹中创建该文件夹。

搜索文件夹生命周期

由于以下一个原因，Exchange Online创建的应用程序创建的搜索文件夹：

1. 搜索文件夹在 45 天未使用后过期。
2. 每个源文件夹可创建的搜索文件夹数量存在限制。 如果超过此限制，将删除较旧的搜索文件夹，为新的搜索文件夹提供途径。

删除搜索文件夹后，应用应新建一个搜索文件夹资源，并使用相同的资源。

方法

方法	返回类型	说明
创建搜索文件夹	mailSearchFolder	在此用户的邮箱中创建搜索文件夹。
列出搜索文件夹	mailFolder 集合	列出此用户邮箱中所有文件夹，包括搜索文件夹。
获取搜索文件夹	mailSearchFolder	获取指定的搜索文件夹。
更新搜索文件夹	mailSearchFolder	更新指定的搜索文件夹。
删除搜索文件夹	None	删除指定的搜索文件夹。
列出搜索文件夹中的所有邮件	邮件集合	列出指定搜索文件夹中的所有邮件。

属性

属性	类型	说明
isSupported	Boolean	指示搜索文件夹是否可以使用 REST API 进行编辑。
includeNestedFolders	Boolean	指示如何在搜索中遍历邮箱文件夹层次结构。 true 意味着应该执行深层搜索，以在 sourceFolderIds 中显式指定的每个文件夹的层次结构中包括子文件夹。 false 表示仅对 sourceFolderIds 中显式指定的每个文件夹进行浅表搜索。
sourceFolderIds	String collection	应缩小的邮箱文件夹。
filterQuery	String	用于筛选邮件的 OData 查询。

JSON 表示形式

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

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