次の方法で共有


別の形式でファイルをダウンロードする

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

この API を使用して、アイテムのコンテンツを特定の形式で取得します。 すべてのファイルがすべての形式に変換できるわけではありません。

アイテムを元の形式でダウンロードするには、「アイテムのコンテンツをダウンロードする」を参照してください。

この 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 /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}

クエリ パラメーター

パラメーター 説明
format 文字列 アイテムのコンテンツをダウンロードする形式を指定します。
height Int32 変換されたイメージの目的の高さ (ピクセル単位)。 format=jpg時に必要です。
Int32 変換されたイメージの目的の幅 (ピクセル単位)。 format=jpg時に必要です。

format パラメーターには次の値を指定できます。

説明 サポートされているソースの拡張子
glb アイテムを GLB 形式に変換する cool、fbx、obj、ply、stl、3mf
html アイテムを HTML 形式に変換する loop, fluid, wbtx, ホワイトボード
jpg アイテムを JPG 形式に変換する 3g2、3gp、3gp2、3gpp、3mf、ai、arw、asf、avi、bas、bash、bat、bmp、c、cbl、cmd、cool、cpp、cr2、crw、cs、css、csv、cur、dcm、dcm30、dic、dicm、dicom、dng、doc、docx、dwg、eml、epi、eps、epsf、epsi、epub、erf、fbx、fppx、gif、glb、h、hcp、heic、heif、htm、html、ico、icon、java、jfif、jpeg、jpg、js、json、key、log、m2ts、m4a、m4v、markdown、md、mef、mov、movie、mp3、mp4、mp4v、mrw、msg、mts、nef、nrw、numbers、obj、odp、odt、ogg、orf、pages、pano、pdf、pef、php、pict、pl、ply、png、pot、potm、potx、pps、ppsx、ppsxm、ppt、pptm、pptx、ps、ps1、psb、psd、py、raw、rb、rtf、rw1、rw2、sh、sketch、sql、sr2、stl、tif、tiff、ts、txt、vb、webm、wma、wmv、xaml、xbm、xcf、xd、xml、xpm、yaml、yml
pdf アイテムを PDF 形式に変換する doc, docx, dotx, dotm, dsn, dwg, eml, epub, fluidframework, form, htm, html, loop, loot, markdown, md, msg, note, odp, ods, ods, odt, page, ppsx, pptx, pulse, rtf, task, tif, tiff, wbtx, whiteboard, xls, xlsm, xlsm, xlsx, xlsx

オプションの要求ヘッダー

名前 説明
if-none-match String この要求ヘッダーが含まれている場合、指定された eTag (または cTag) がファイルの現在のタグに一致すると、HTTP 304 Not Modified 応答が返されます。

GET /drive/items/{item-id}/content?format={format}

応答

変換されたファイルの事前認証されたダウンロード URL にリダイレクトする、302 Found 応答を返します。

変換されたファイルをダウンロードするには、アプリが応答の Location ヘッダーに従う必要があります。

事前認証された URL は短時間 (数分) のみ有効であり、アクセスに Authorization ヘッダーは必要ありません。

HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi

エラー応答

エラーの返し方の詳細については、「エラー応答」を参照してください。