OneDrive ファイル ストレージ API の概要OneDrive file storage API overview

OneDrive は、Microsoft 365 のファイル ハブです。OneDrive is the files hub in Microsoft 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.

Microsoft 365 のファイルはドライブに保存されています。Files in Microsoft 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. ユーザーは、ファイルへのリンクを共有したり、ファイルをチーム ドライブにコピーまたは移動したり、Outlook で OneDrive ファイルをメール メッセージに添付したりすることができます。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 アプリは 5 億を超えるデバイスで実行されており、Fortune 500 企業の 85% 以上が OneDrive for Business を使用しています。アプリを 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 に保存すると、アプリで Microsoft クラウドのさまざまな機能を利用することができ、ユーザーはどこからでも自分のファイルにアクセスすることができるようになります。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 から直接取得したり、Microsoft Graph API を直接使用してファイルに関する深い対話操作を実行したりします。Get information about selected files directly from the picker SDK, or use Microsoft Graph APIs directly to interact more deeply with files. 特殊フォルダーを使用して、DocumentsCamera Roll など、OneDrive 上のよく知られた場所にファイルを保存したり、アプリに独自の個人用フォルダーを割り当てたりします。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.

OneDrive 内からユーザーに対してアプリを直接立ち上げるBring 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. プレビュー API (ベータ版) を使用することにより、OneDrive ファイルのプレビューをアプリ内に埋め込むこともできます。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. Excel API は、Excel ブックに保存されている生のデータを直接操作するために使用します。Use the Excel API to work directly with the raw data stored in an Excel workbook. Notes API は、OneNote のノートブックの内容にアクセスするために使用します。Use the Notes API to access the contents of OneNote notebooks.

ファイルへの変更に対応するReact to file changes

アプリは webhooks によって、ファイルに変更が加えられた時点で通知を受け取り、それに短時間で対応することができます。With webhooks, your app can get notified when files change so you can quickly react. delta API を使用することにより、アプリがクラウドと同期した最後の時点以降で、どのような変更が加えられたかを調べます。Use the delta API to see what changed since the last time your app synchronized with the cloud.

API リファレンスAPI reference

このサービスの API リファレンスをお探しですか?Looking for the API reference for this service?

次の手順Next steps

Microsoft Graph v1.0 における OneDrive API の使用に関する詳細を確認する。Find out more about using the OneDrive API in Microsoft Graph v1.0.