Файлы
Элементы группы Office 365 → Файлы предназначены для работы с файлами и папками в OneDrive и в библиотеках документов SharePoint: поиска, загрузки, скачивания, копирования, перемещения, удаления и предоставления доступа. Все элементы размещаются внутри контейнера Microsoft 365.
- Найти папки и файлы — получение содержимого папки или поиск файлов.
- Получить файл или папку — получение файла по ID или по ссылке.
- Создать папку — создание папки.
- Загрузить файл — загрузка локального файла в OneDrive или SharePoint.
- Скачать файл — сохранение файла на локальный диск.
- Экспортировать как PDF — сохранение документа в формате PDF.
- Копировать файл или папку — копирование в другую папку.
- Переместить файл или папку — перемещение и переименование.
- Удалить файл или папку — удаление в корзину.
- Поделиться файлом или папкой — создание ссылки общего доступа.
Необходимые разрешения Microsoft Graph: Files.ReadWrite.All, для SharePoint дополнительно Sites.ReadWrite.All. Подробнее — в разделе Настройка доступа к Microsoft 365.
Где искать файлы
Элементы Найти папки и файлы и Получить файл или папку определяют диск по свойствам Учетная запись, URL и Диск:
| Учетная запись | URL | Диск | Где выполняется поиск |
|---|---|---|---|
| не заполнено | не заполнено | не заполнено | OneDrive пользователя, под которым выполнен вход (только при входе по логину) |
"user@company.ru" | не заполнено | не заполнено | OneDrive указанного пользователя |
| любое | "https://company.sharepoint.com/sites/Finance" | не заполнено | основная библиотека документов сайта SharePoint |
| любое | "https://company.sharepoint.com/sites/Finance" | "Архив" | библиотека документов «Архив» сайта SharePoint |
Важно: В свойстве URL указывается адрес сайта SharePoint, например https://company.sharepoint.com/sites/Finance. Адрес библиотеки или страницы (.../Shared Documents/Forms/AllItems.aspx) не подходит. При заполненном URL свойство Учетная запись не учитывается.
Диск — имя библиотеки документов в том виде, как оно отображается на сайте SharePoint (Документы, Documents, Архив). Регистр не важен.
Объект DriveItem
Элементы группы возвращают и принимают файлы и папки в виде объектов Microsoft.Graph.Models.DriveItem. Объект, полученный одним элементом, передается в свойства Источник, Папка, Файл других элементов, а также в свойство Книга элементов Excel.
| Выражение | Значение |
|---|---|
item.Name | Имя файла или папки |
item.Id | Идентификатор |
item.Folder != null | Признак папки |
item.File != null | Признак файла |
item.Size | Размер в байтах |
item.WebUrl | Адрес для открытия в браузере |
item.LastModifiedDateTime | Дата изменения (UTC) |
item.ParentReference.Path | Путь к родительской папке |