大网数据广告活动
Microsoft Graph 接口

mailSearchFolder 资源类型

· 52CE 我爱测

mailSearchFolder 是用户邮箱中的虚拟文件夹,其中包含符合指定搜索条件的所有电子邮件项目。 mailSearchFolder 继承自 mailFolder。

命名空间: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"
}

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 abheek-das)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。