Создание списка дочерних элементов ресурса driveItem

  • Статья

Возвращает коллекцию DriveItems в дочерние элементы ресурса DriveItem.

Ресурсы DriveItem с аспектом папки или пакета, отличным от NULL, могут содержать один или несколько дочерних элементов DriveItem.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Для приложений Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-запрос

GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/items/{item-id}/children
GET /me/drive/items/{item-id}/children
GET /sites/{site-id}/drive/items/{item-id}/children
GET /users/{user-id}/drive/items/{item-id}/children

Необязательные параметры запросов

Этот метод поддерживает $expandпараметры запроса ,$select, $skipTokenи $orderby$top OData для настройки ответа.

Необязательные заголовки запросов

Имя Значение Описание
if-none-match etag Если указан этот заголовок запроса, а предоставленный тег eTag (или cTag) совпадает с текущим тегом файла, то будет возвращен ответ HTTP 304 Not Modified.

Примеры

Создание списка дочерних элементов в корневой папке диска текущего пользователя

Чтобы получить файлы, расположенные в корневой папке диска, используйте связь root для диска, а затем получите доступ к связи дочернего элемента.

GET /me/drive/root/children

Создание списка дочерних элементов ресурса driveItem с использованием известного идентификатора

Чтобы получить файлы, расположенные в корневой папке диска, используйте связь root для диска, а затем получите доступ к связи дочернего элемента.

GET /drives/{drive-id}/items/{item-id}/children

Создание списка дочерних элементов ресурса driveItem с использованием известного пути

GET /drives/{drive-id}/root:/{path-relative-to-root}:/children

Ответ

При успешном выполнении этот метод возвращает список элементов в коллекции дочерних элементов для целевого элемента. Коллекция дочерних элементов будет состоять из ресурсов driveItem.

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-адрес для следующей страницы элементов.

Вы можете управлять размером страницы с помощью необязательных параметров строки запроса

Ответы с ошибками

Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.