specialFolder 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

将与文件夹相关的特殊数据项分组到单个结构中。

如果 driveItem 具有非 null specialFolder facet，则该项表示名为) 文件夹的特殊 (。可直接通过 special folders 集合访问特殊文件夹。

特殊文件夹可提供简单别名，因此无需按路径查找（需要本地化）文件夹或通过 ID 引用文件夹来访问已知文件夹。如果特殊文件夹被重命名或移到驱动器中的其他位置，此语法将继续返回该文件夹。

应用程序第一次尝试向特殊文件夹中写入内容时，如果特殊文件夹不存在，系统会自动创建特殊文件夹。如果用户删除某个特殊文件夹，再次向其写入内容时会重新创建特殊文件夹。

OneDrive 和 OneDrive for Business 中提供了以下特殊文件夹名称。

名称	文件夹 ID	说明
Documents	`documents`	“文档”文件夹。
Photos	`photos`	“照片”文件夹。
Camera Roll	`cameraroll`	“本机照片备份”文件夹。
App Root	`approot`	应用程序的个人文件夹。通常位于中 `/Apps/{Application Name}`。
Music	`music`	“音乐”文件夹。
录音	`recordings`	“录制”文件夹。此选项仅在 OneDrive for Business 和 SharePoint Online 中可用。

注意：如果应用仅请求 Files.Read 范围，而请求特殊文件夹不存在，则响应将是 403 Forbidden 错误。

属性

属性	类型	说明
name	string	此项在 `/drive/special` 集合中的唯一标识符。

{
  "name": "string"
}

有关 driveItem 上的分面的详细信息，请参阅 driveItem。