Обзор API для хранилища файлов OneDriveOneDrive file storage API overview

OneDrive является центром файлов в Office 365.OneDrive is the files hub in Office 365. Люди работают с файлами в различных контекстах, например Microsoft Teams, группах, SharePoint и т. д.People work with files in a variety of contexts, like Microsoft Teams, groups, SharePoint, and more. С OneDrive пользователи открывать эти файлы независимо от того, где они хранятся, а с Microsoft Graph для работы с ними можно использовать один API.With OneDrive, users can access these files no matter where they are stored, and with Microsoft Graph, you can use a single API to work with them.

Файлы в Office 365 хранятся на дисках.Files in Office 365 are stored in drives. Пользователи могут хранить файлы на личном (своем OneDrive) либо общем диске на базе библиотеки документов SharePoint.Users can store files in a personal drive - their OneDrive - or in a shared drive powered by a SharePoint document library. Гибкость OneDrive позволяет пользователям работать с коллегами так, как им удобно.OneDrive's flexibility lets users collaborate however it works best for them. Пользователи могут делиться ссылками на файлы, копировать либо перемещать файлы на диски групп или даже прикреплять файлы OneDrive к почтовым сообщениям в Outlook.Users can share links to files, copy or move files to team drives, or even attach OneDrive files to mail messages in Outlook.

Преимущества интеграции с облачным файловым хранилищем OneDrive?Why integrate with OneDrive file storage in the cloud?

Использование экосистемы с миллиардами файловTap into an ecosystem with billions of files

Пользователи OneDrive могут получать доступ к своим файлам с любого устройства как подключением, так и без подключения к Интернету, и делиться ими с коллегами, так и с внешними пользователями.OneDrive users can access their files from any device, online or offline, and share files with people inside or outside their organization. OneDrive позволяет совместно работать над документами в режиме реального времени в знакомых приложениях, таких как Word, Excel и PowerPoint.OneDrive enables real-time coauthoring in familiar apps like Word, Excel, and PowerPoint. Платформа Microsoft Graph обеспечивает информативные эскизы для сотен форматов файлов, потоковой передачи видео, аналитики и многого другого.Files light up with rich thumbnails for hundreds of formats, video streaming, analytics, and more, powered by Microsoft Graph. Данные в OneDrive защищены передовыми технологиями шифрования, соответствия требованиям и безопасности, которым доверяют клиенты.Data in OneDrive is protected with advanced encryption, compliance, and security features that customers trust.

Поскольку приложение OneDrive работает на более чем 500 миллионах устройств и более 85 % компаний из списка Fortune 500 используют OneDrive для бизнеса, интеграция вашего приложения с OneDrive позволит вам охватить миллионы потребителей, учащихся и бизнес-пользователей и взаимодействовать с клиентами там, где они уже работают каждый день.With over 500 million devices running the OneDrive app and over 85% of the Fortune 500 using OneDrive for Business, by integrating your app with OneDrive, you can connect with millions of consumers, students, and business users and engage with customers where they already do their work every day.

Хранение файлов вашего приложения в мощном облакеStore your app's files in a powerful cloud

Когда вы храните файлы в OneDrive, ваше приложение может использовать возможности облака Майкрософт, а ваши пользователи могут получать доступ к своим файлам, где бы они ни находились.When you store your files in OneDrive, your app can take advantage of the features of the Microsoft cloud and your users can access their files anywhere. Используйте пакет SDK для [средства выбора файлов][], чтобы быстро открывать, скачивать и сохранять файлы, хранимые в OneDrive, а также делиться ими из вашего приложения через знакомый интерфейс OneDrive.Use the file picker SDK to quickly open, download, save, or share files stored in OneDrive from within your own app, using the same experience OneDrive users are familiar with. Получайте информацию о выбранных файлах прямо из пакета SDK или используйте API Microsoft Graph для более глубокого взаимодействия с файлами.Get information about selected files directly from the picker SDK, or use Microsoft Graph APIs directly to interact more deeply with files. Используйте специальные папки, чтобы хранить файлы в известных папках OneDrive, например Documents и Camera Roll, или предоставьте своему приложению собственную папку.Use special folders to store files in well-known locations on OneDrive, like Documents and Camera Roll, or give your app its own personal folder.

Подача вашего приложения напрямую пользователям в OneDriveBring your app straight to users within OneDrive

Клиенты OneDrive могут запускать ваше приложение прямо из OneDrive, чтобы открывать, редактировать или просматривать файлы.OneDrive customers can use or launch your app directly from within OneDrive to open, edit, or preview files. Используйте расширения [обработчика файлов][] OneDrive, чтобы предоставить значки и эскизы для своих расширений файлов; добавьте свое приложение в кнопку Создать или даже действия в строку меню для запуска своего приложения.Use OneDrive's file handler extensions to provide icons and previews for your own custom file extensions, add your app to the New button or even add your own custom actions to the menu bar to launch your app.

Работа с содержимым в форматах, которые понимает ваше приложениеWork with content in formats your app understands

Ваше приложение может получить содержимое в наиболее удобном для вас формате.Your app can get file content in the format that is most convenient for you. Приложение может отображать эскизы нестандартного размера для сотен различных форматов файлов.Your app can display custom-sized thumbnails for hundreds of different file formats. Вы можете скачивать файлы в различных альтернативных [форматах][], например PDF.You can download files in a variety of alternative formats, like PDF. Вы даже можете внедрить предварительный просмотр файлов OneDrive в свое приложение, воспользовавшись API [предварительного просмотра][] (бета-версия).You can even embed the OneDrive file previewers within your app by using the preview API (beta).

Работа с содержимым и метаданными файла без скачивания двоичных данныхWork with file content and metadata without downloading the binary

Microsoft Graph открывает доступ к различному содержимому через REST API без необходимости скачивания двоичных данных.With Microsoft Graph, you can access rich content through REST APIs without having to download the binary. Изучайте извлеченные метаданные из [фотографий][], [аудиофайлов][] и [видеофайлов][].Explore extracted metadata from photo, audio, and video files. Используйте API Excel для работы с необработанными данными, хранящимися в книге Excel.Use the Excel API to work directly with the raw data stored in an Excel workbook. Используйте API заметок для доступа к содержимому записных книжек OneNote.Use the Notes API to access the contents of OneNote notebooks.

Реагирование на изменения файловReact to file changes

С помощью [веб-перехватчиков][] ваше приложение может получать уведомления при изменении файлов, чтобы вы могли быстро отреагировать.With webhooks, your app can get notified when files change so you can quickly react. Используйте API изменений, чтобы посмотреть, что изменилось с момента последней синхронизации вашего приложения с облаком.Use the delta API to see what changed since the last time your app synchronized with the cloud.

Справочные материалы по APIAPI reference

Ищете справочные материалы по API для этой службы?Looking for the API reference for this service?

Дальнейшие действияNext steps

Узнайте больше об использовании API OneDrive в Microsoft Graph версии 1.0.Find out more about using the OneDrive API in Microsoft Graph v1.0.