Тип ресурса SpecialFolder

  • Статья

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

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

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

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

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

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

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

{
  "name": "string"
}

Свойства

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

Специальные папки

Вот специальные папки, доступные в OneDrive персональный и OneDrive для бизнеса.

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

Заметки

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