Хранение файлов и доступ к ним в SharePoint Embedded с помощью REST API Microsoft Graph

Завершено

Разработчики, создающие приложения, использующие SharePoint Embedded, будут использовать хорошо известные и установленные API Microsoft Graph для доступа к файлам и документам в этих контейнерах. Конечная точка диска Microsoft Graph может получать доступ к данным, хранящимся в внедренном контейнере SharePoint. В этом разделе описано, как использовать REST API Microsoft Graph для хранения и извлечения файлов и документов в внедренных контейнерах SharePoint.

Важно!

В настоящее время многие конечные точки Microsoft Graph, используемые для создания, доступа к ресурсу SharePoint Embedded и управления ими, существуют только в бета-версии конечной точки Microsoft Graph. Однако все конечные точки, которые обращаются к контейнерам и содержимому внутри содержатся, находятся в конечной точке Microsoft Graph версии 1.0.

Работа с контейнерами

После завершения всех процессов настройки и регистрации между поставщиком и потребляющими клиентами необходимо создать контейнер в потребляемом клиенте.

Создание контейнера

Чтобы создать контейнер, отправьте HTTP POST с полезными данными JSON, указывающими имя, описание и связанный идентификатор ContainerType:

POST https://graph.microsoft.com/beta/storage/fileStorage/containers

{
  "displayName": "Sample App Container 1",
  "description": "First container description.",
  "containerTypeId": "{{ContainerTypeId}}"
}

Microsoft Graph ответит подробными сведениями о новом контейнере:

{
  "id": "b!qEMTpi-XGEKZ1W...",
  "displayName": "Sample App Container 1",
  "description": "First container description.",
  "containerTypeId": "3a6b1fc4-0b09-04b3-3a2a-4843fbb60914",
  "status": "inactive",
  "createDateTime": 2023-11-T00:15:25.84Z"
}

Вывод списка всех контейнеров

Чтобы получить список всех созданных контейнеров, отправьте HTTP-запрос GET и отфильтруйте его по идентификатору ContainerType:

GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {{ContainerTypeId}}

Получение определенного контейнера

Чтобы получить определенный контейнер, отправьте HTTP-запрос GET в конечную точку Containers :

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{{ContainerID}}?$select=id,displayName,containerTypeId,status,description,customProperties&$expand=permissions

Работа с содержимым контейнера

Для работы с содержимым или файлами в контейнере используются те же конечные точки Microsoft Graph, которые доступны для чтения и записи в библиотеки документов SharePoint или OneDrive: конечная drives точка. Это связано с тем, что внедренный контейнер SharePoint рассматривается как то же самое, что и объект Microsoft GraphDrive, а файлы в объекте Drive — .DriveItems

Получение определенного контейнера в Drive качестве объекта

Чтобы получить определенный контейнер в качестве объекта Drive, отправьте HTTP-запрос GET в конечную точку Microsoft Graph drives :

GET https://graph.microsoft.com/v1.0/drives/{{ContainerID}}

Дополнительные сведения о конечной точке Microsoft Graph drives см. в статье Rest API Microsoft Graph: Получение диска.

Вывод списка содержимого контейнера

Чтобы получить содержимое контейнера, отправьте HTTP-запрос GET в ту же конечную точку, но перейдите к дочерним элементам контейнера:

GET https://graph.microsoft.com/v1.0/drives/{{ContainerID}}/items/root/children

Отправка файла в контейнер

Чтобы отправить файл в контейнер, отправьте HTTP-запрос POST в конечную точку drives и включите содержимое файла в запрос:

PUT https://graph.microsoft.com/v1.0/drives/{{ContainerId}}/root:/Jan2024.docx:/content

<binary contents of the file>

Удаление содержимого контейнера

Чтобы удалить файл из контейнера, отправьте ЗАПРОС HTTP DELETE в конечную точку drives :

DELETE https://graph.microsoft.com/v1.0/drives/{{ContainerID}}/items/root/{{driveItemID}}

Дополнительные сведения о работе с файлами с помощью Microsoft Graph см. в статье Rest API Microsoft Graph: элементы диска.

Сводка

Разработчики, создающие приложения, использующие SharePoint Embedded, будут использовать хорошо известные и установленные API Microsoft Graph для доступа к файлам и документам в этих контейнерах. Конечная точка диска Microsoft Graph может получать доступ к данным, хранящимся в внедренном контейнере SharePoint.

В этом разделе вы узнали, как использовать REST API Microsoft Graph для хранения и извлечения файлов и документов в внедренных контейнерах SharePoint.

Продолжить