列出 DriveItem 的子项

在 DriveItem 的 children 关系中返回 DriveItems 集合。

具有非 null 文件夹 facet 的 DriveItem 可以拥有一个或多个子 DriveItem。

先决条件

要执行此 API,需要以下范围之一:

  • Files.Read
  • Files.ReadWrite
  • Files.Read.All
  • Files.ReadWrite.All
  • Sites.Read.All
  • Sites.ReadWrite.All

HTTP 请求

GET /me/drive/root/children
GET /me/drive/items/{item-id}/children
GET /me/drive/root:/{item-path}:/children
GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/root/children
GET /groups/{group-id}/drive/items/{item-id}

可选的查询参数

此方法支持 OData 查询参数 来帮助自定义响应。

请求标头

名称 类型 说明
if-none-match String 如果包含此请求标头,且提供的 eTag(或 cTag)与文件中的当前标记不匹配,则返回 HTTP 304 Not Modified 响应。

请求正文

请勿提供此方法的请求正文。

示例

请求

下面是请求返回当前用户 OneDrive 的根文件夹中的 DriveItems 的示例。

GET https://graph.microsoft.com/v1.0/me/drive/root/children

响应

下面是一个响应示例。

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {"name": "myfile.jpg", "size": 2048, "file": {} },
    {"name": "Documents", "folder": { "childCount": 4} },
    {"name": "Photos", "folder": { "childCount": 203} },
    {"name": "my sheet(1).xlsx", "size": 197 }
  ],
  "@odata.nextLink": "https://..."
}

注意:如果集合超出默认页面大小(200 项),则在响应中返回 @odata.nextLink 属性以指示有更多项可用,并提供下一页项目的请求 URL。

可以通过 可选的查询字符串参数 控制页面大小