Создание списка доступных объектов drive

Статья
04/08/2023

В этой статье рассказывается, как получить список ресурсов Drive, доступных для целевого объекта User, Group или Site.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Для приложений	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Создание списка дисков группы

Чтобы создать список библиотек документов для группы, ваше приложение должно запросить связь drives в объекте Group.

HTTP-запрос

GET /groups/{groupId}/drives

Создание списка дисков сайта

Чтобы создать список библиотек документов для сайта, ваше приложение должно запросить связь drives в объекте Site.

GET /sites/{siteId}/drives

Создание списка дисков пользователя

GET /users/{userId}/drives

Создание списка дисков текущего пользователя

GET /me/drives

Необязательные параметры запросов

Этот метод поддерживает $expandпараметры запроса ,$select, $skipToken, $topи $orderby OData для настройки ответа.

Ответ

При успешном выполнении этот метод возвращает код ответа 200 OK и коллекцию объектов Drive в теле ответа.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

Примечания

У большинства пользователей имеется только один ресурс Drive.

Для групп и сайтов может быть доступно несколько ресурсов Drive.

По умолчанию ресурсы Drive с аспектом system скрыты. Чтобы создать их список, включите параметр system в оператор $select.

Share via