Тип ресурса 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
В следующем представлении JSON показан тип ресурса.
{
"name": "string"
}
Связанные материалы
Дополнительные сведения о аспектах в driveItem см. в разделе driveItem.