Начало работы с API OneDrive

  • Статья

На этой странице кратко рассказывается о действиях, которые необходимо выполнить, чтобы использовать Microsoft Graph и API OneDrive. Подробные пошаговые инструкции см. в кратком руководстве по началу работы с Microsoft Graph.

Если вы работаете с SharePoint Server 2016 либо не используете Microsoft Graph, ознакомьтесь со статьей об использовании API OneDrive с SharePoint Server 2016.

1. Аутентификация пользователя и авторизация приложения

Для авторизации в Microsoft Graph и API OneDrive используется OAuth 2.0. Выполнив поток OAuth, приложение получит маркер доступа, предоставляющий доступ к Microsoft Graph с определенным набором разрешений для пользователя.

В каждом запросе приложение будет отправлять маркер доступа в заголовке HTTP:

Authorization: bearer {token}

Дополнительные сведения об авторизации приложения и получении маркера доступа см. в статье о проверке подлинности приложений в Microsoft Graph.

2. Совершение вызовов к ресурсу

После того как приложение будет авторизовано и получит маркер доступа, оно сможет совершать запросы на ресурсы OneDrive или SharePoint к конечной точке Microsoft Graph. Чтобы создать URL-адрес для ресурса, необходимо знать относительный URL-адрес корневого ресурса (например, user, group или site) и ресурса drive или driveItem, являющегося целью запроса.

URL-запроса включает указанные ниже компоненты.

  • URL-адрес корня и версия Microsoft Graph (https://graph.microsoft.com/v1.0)
  • Цель корневого ресурса (/users/{id})
  • Цель ресурса API OneDrive (/drive, /drives/{id}/items/{item-id} или /drive/root:/path/to/item)

Примечание. Для краткости в данной документации используется только частичный синтаксис, например GET /drive/items/{item-id}. Чтобы получить полный путь или URL-адрес ресурса, добавьте к пути префикс, представляющий собой правильный URL-адрес корня и цель корневого ресурса.

3. Дальнейшие действия

Дополнительные сведения об использовании файлов в Microsoft Graph см. в примерах для OneDrive на GitHub и примерах для Microsoft Graph на GitHub.

Дополнительные сведения о работе с ресурсами drive и driveItem см. в документации по HTTP API OneDrive. Дополнительные сведения обо всех ресурсах в Microsoft Graph см. в документации по Microsoft Graph.

Возникли вопросы или требуется помощь? Вы можете обратиться к нам на Stack Overflow и на странице проблем GitHub, связанных с нашей документацией.