Тип ресурса specialFolder

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Группирование специальных элементов данных, связанных с папками, в одну структуру.

Если элемент driveItem имеет аспект specialFolder , отличный от NULL, элемент представляет специальную папку (именованную) папку. Доступ к специальным папкам можно получить через коллекцию специальных папок.

Специальные папки предоставляют простые псевдонимы для доступа к известным папкам, чтобы не нужно было искать папку по пути (что требует локализации) или ссылаться на папку по идентификатору. При переименовании специальной папки или ее перемещении в другое расположение на диске команда с таким синтаксисом будет по-прежнему возвращать эту папку.

Когда приложение впервые пробует записать что-то в специальную папку, она создается автоматически, если не была создана ранее. Если пользователь удалил такую папку, она создается повторно при записи в нее.

В OneDrive и OneDrive для бизнеса доступны следующие специальные имена папок.

имя;	Идентификатор папки	Описание
Документы	documents	Папка "Документы".
Фотографии	photos	Папка "Фотографии".
Альбом камеры	cameraroll	Папка для резервных копий альбома камеры.
Корневая папка приложения	approot	Личная папка приложения. Обычно в /Apps/{Application Name}.
Музыка	music	Папка "Музыка".
Записи	recordings	Папка Recordings. Этот параметр доступен только в OneDrive для бизнеса и SharePoint Online.

Примечание. Если ваше приложение запросило только область Files.Read и запрашивает специальную папку, которая не существует, в качестве отклика будет возвращена ошибка 403 Forbidden.

Свойства

Свойство	Тип	Описание
name	string	Уникальный идентификатор для этого элемента в коллекции /drive/special.

Представление JSON

{
  "name": "string"
}

Связанные материалы

Дополнительные сведения о аспектах в driveItem см. в разделе driveItem.