OneDrive API の概要
このページでは、Microsoft Graph と OneDrive API を使用するために必要になる手順の概要について簡単に説明します。 詳細な手順については、「Microsoft Graph クイック スタート」を確認してください。
SharePoint Server 2016 を使用して作業する場合、または Microsoft Graph を使用しない場合は、「SharePoint Server 2016 で OneDrive API を使用する」のトピックを参照してください。
1. ユーザー認証とアプリの承認
Microsoft Graph および OneDrive API では、承認に OAuth 2.0 を使用します。 OAuth フローを完了すると、アプリはユーザーの代わりに特定のアクセス許可のセットである Microsoft Grap へのアクセスを提供するアクセス トークンを受け取ります。
アプリでは、次に示すように、要求ごとに HTTP ヘッダーでアクセス トークンを提示します。
Authorization: bearer {token}
アプリケーションの承認とアクセス トークンの詳細については、「Microsoft Graph でのアプリの認証」を参照してください。
2. リソースに対する呼び出しを実行する
アプリは承認後にアクセス トークンを受け取ると、OneDrive または SharePoint のリソースに対応する Microsoft Graph エンドポイントに要求を送信できるようになります。 リソースの URL を作成するには、要求のターゲットとしているルート リソース (user、group、site など) と drive リソースまたは driveItem リソースの URL がわかっている必要があります。
要求 URL には、次のコンポーネントが含まれています。
- Microsoft Graph のルート URL とバージョン (
https://graph.microsoft.com/v1.0) - ルート リソースのターゲット (
/users/{id}) - OneDrive API リソースのターゲット (
/drive、/drives/{id}/items/{item-id}または/drive/root:/path/to/item)
注: このドキュメント全体にわたって、簡略化のために GET /drive/items/{item-id} のような部分的な構文のみを使用しています。
完全なリソース パスまたは URL を取得するには、適切なルート URL とルート リソース ターゲットをパスの先頭に追加してください。
3. 次の段階に進む
GitHub の OneDrive のサンプルと GitHub の Microsoft Graph のサンプルをチェックアウトして、Microsoft Graph のファイルの使用方法について理解してください。
OneDrive API HTTP のドキュメントをよく読んで、drive リソースと driveItem リソースの操作方法について理解してください。 Microsoft Graph のすべてのリソースの詳細については、「Microsoft Graph のドキュメント」を参照してください。
質問またはサポートについて: 「Stack Overflow」と このドキュメントに関する GitHub の「Issues」ページでお問い合わせください。