名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
特定の バージョン の driveItem の内容を取得します。
メモ: 現在のバージョンのコンテンツの取得はサポートされていません。 代わりに、 driveItem コンテンツ エンドポイントを使用します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Files.Read | Files。Read.All、Files。ReadWrite、Files。ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | Files.Read | Files。Read.All、Files。ReadWrite、Files。ReadWrite.All |
| アプリケーション | Files.Read.All | Files。ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All |
注:
SharePoint Embedded には、コンテナーのコンテンツにアクセスするための FileStorageContainer.Selected アクセス許可が必要です。 このアクセス許可は、前に説明した権限とは異なります。 Microsoft Graph のアクセス許可に加えて、アプリには、この API を呼び出すために必要な コンテナーの種類のアクセス許可 が必要です。 詳細については、「 SharePoint Embedded の認証と承認」を参照してください。
HTTP 要求
GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
GET /groups/{group-id}/drive/items/{item-id}/versions/{version-id}/content
GET /me/drive/items/{item-id}/versions/{version-id}/content
GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id}/content
GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content
応答
ファイルのバイト数の事前認証されたダウンロード URL にリダイレクトする 302 Found 応答を返します。
ファイルの内容をダウンロードするには、アプリケーションが応答の Location ヘッダーに従う必要があります。
多くの HTTP クライアント ライブラリは、自動的に 302 リダイレクションに従い、即座にファイルのダウンロードを開始します。
事前認証されたダウンロード URL は短時間 (数分) のみ有効であり、ダウンロードに Authorization ヘッダーは必要ありません。
例
例 1: 以前のバージョンのファイルの内容をダウンロードする
この例では、現在のユーザーのドライブ内のファイルのバージョンを取得します。
要求
GET /me/drive/items/{item-id}/versions/{version-id}/content
応答
バージョンの内容をダウンロードできる場所へのリダイレクトを返します。
HTTP/1.1 302 Redirect
Location: https://onedrive.com/34FF49D6...
例 2: 以前のバージョンのファイルから部分的なバイト範囲をダウンロードする
driveItemVersion からバイト範囲の一部をダウンロードするには、RFC 2616 で指定されているRange ヘッダーをアプリで使用できます。 リダイレクトに従うときは、/contentの要求ではなく、Range ヘッダーを追加する必要があります。
GET https://onedrive.com/34FF49D6...
Range: bytes=0-1023
呼び出しは、ファイルからのバイトの要求範囲を持つ HTTP 206 Partial Content 応答を返します。
範囲を生成できない場合、 Range ヘッダーは無視され、ファイルの完全な内容を含む HTTP 200 応答が返されます。
HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/2048
<first 1024 bytes of file>
注釈
OneDrive では、以前のバージョンのファイルの完全なメタデータは保持されません。
アプリがファイルの使用可能なバージョンの一覧を取得すると、特定のバージョンに関する利用可能な情報を提供する driveItemVersion リソースが返されます。