Получение ресурса DriveItem

  • Статья

Получение метаданных для DriveItem в объекте Drive по пути в файловой системе или идентификатору.

Разрешения

Для вызова этого 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

HTTP-запрос

GET /drives/{drive-id}/items/{item-id}
GET /drives/{drive-id}/root:/{item-path}
GET /groups/{group-id}/drive/items/{item-id}
GET /groups/{group-id}/drive/root:/{item-path}
GET /me/drive/items/{item-id}
GET /me/drive/root:/{item-path}
GET /sites/{siteId}/drive/items/{itemId}
GET /sites/{siteId}/drive/root:/{item-path}
GET /users/{userId}/drive/items/{itemId}
GET /users/{userId}/drive/root:/{item-path}

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

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

С помощью $expandпараметра строки запроса вы можете включить дочерние элементы запрос на получение метаданных элемента при наличии дочерней связи.

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

Имя Значение Описание
if-none-match String Если указан этот заголовок запроса, а предоставленный тег eTag (или cTag) совпадает с текущим тегом файла, то будет возвращен ответ HTTP 304 Not Modified.

Ответ

В случае успеха этот метод возвращает код отклика 200 OK и ресурс DriveItem в тексте отклика.

Пример

Запрос

Ниже приведен пример запроса к корневой папке OneDrive пользователя.

GET /me/drive/root

Отклик

Ниже приведен пример отклика.

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

{
  "createdBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "createdDateTime": "2016-03-21T20:01:37Z",
  "cTag": "\"c:{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},0\"",
  "eTag": "\"{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},1\"",
  "folder": { "childCount": 120 },
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "lastModifiedBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "lastModifiedDateTime": "2016-03-21T20:01:37Z",
  "name": "OneDrive",
  "root": { },
  "size": 157286400,
  "webUrl": "https://contoso-my.sharepoint.com/personal/rgregg_contoso_com/Documents"
}

Запросы HEAD

В большинстве случаев запрос HEAD будет работать так же, как запрос GET.

Тем не менее имеется пара указанных ниже отличий.

  1. Запросы HEAD возвращают только заголовки соответствующих запросов GET. Это стандартная практика для ответов HEAD.
  2. Запросы HEAD не подготавливают специальную папку автоматически. Вместо этого, если специальная папка отсутствует, будет возвращена ошибка 404.

В этом примере видно, что при запросе к корню вашего OneDrive будет получен простой ответ 200 OK.

HTTP-запрос

HEAD /drive/root
Accept: application/json

Отклик

HTTP/1.1 200 OK

Примечания

Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.