命名空间：microsoft.graph
表示用户邮箱中的文件夹，例如收件箱、草稿或其他用户创建的文件夹。 文件夹可以包含各种邮箱项目，如邮件、事件、联系人、其他 Outlook 项目和子文件夹。
此资源支持 增量查询 ，通过提供增 量 函数来跟踪增量添加、删除和更新。 它还支持单值和多值扩展属性，用于存储和访问尚未在 Microsoft 图形 API 元数据中公开的自定义数据。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | mailboxFolder 集合 | 获取指定邮箱中的所有 mailboxFolder 对象，包括任何搜索文件夹。 |
| 创建 | mailboxFolder | 在用户的邮箱中新建 mailboxFolder 或子 mailboxFolder 。 |
| Get | mailboxFolder | 读取 mailboxFolder 对象的属性和关系。 |
| 更新 | mailboxFolder | 更新邮箱中的 mailboxFolder 属性，如 displayName 。 |
| 删除 | 无 | 删除邮箱内的 mailboxFolder 或子 mailboxFolder 。 |
| 获取增量 | mailboxFolder 集合 | 获取用户邮箱中添加、删除或删除的一组 mailboxFolder 对象。 |
| 列出子邮箱文件夹 | mailboxFolder 集合 | 获取邮箱中指定 mailboxFolder 下的 mailboxFolder 集合。 |
| 列出文件夹中的项 | mailboxItem 集合 | 获取邮箱中指定 mailboxFolder 内的 mailboxItem 集合。 |
| 扩展属性 | ||
| 创建单值属性 | mailboxFolder | 在新的或现有的邮箱文件夹中创建一个或多个单值扩展属性。 |
| 获取单值属性 | mailboxFolder | 使用 $expand OR $filter获取包含单值扩展属性的邮箱文件夹。 |
| 创建多值属性 | mailboxFolder | 在新的或现有的邮箱文件夹中创建一个或多个多值扩展属性。 |
| 获取多值属性 | mailboxFolder | 使用 $expand获取包含多值扩展属性的邮箱文件夹。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| childFolderCount | Int32 | 当前文件夹中的直系子文件夹的数量。 |
| displayName | String | 文件夹的显示名称。 |
| id | String | 文件夹的唯一标识符。 |
| parentFolderId | String | 此文件夹的父文件夹的唯一标识符。 |
| totalItemCount | Int32 | 文件夹中的项目数。 |
| type | String | 描述文件夹类类型。 |
| wellKnownName | String | Outlook 创建的文件夹的文件夹的已知名称，例如 inbox、sentitems、draftsdeleteditemsarchive、或。 对于用户创建的文件夹，值为 null。 只读。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| childFolders | mailboxFolder 集合 | 此文件夹中的子文件夹集合。 |
| items | mailboxItem 集合 | 此文件夹中的项目集合。 |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty 集合 | 为 mailboxFolder 定义的多值扩展属性的集合。 |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | 为 mailboxFolder 定义的单值扩展属性的集合。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"displayName": "String",
"childFolderCount": "Int32",
"id": "String (identifier)",
"parentFolderId": "String",
"totalItemCount": "Int32",
"wellKnownName": "String",
"type": "String"
}