別の形式でファイルをダウンロードする
この API を使用して、アイテムのコンテンツを特定の形式で取得します。 すべてのファイルがすべての形式に変換できるわけではありません。
アイテムを元の形式でダウンロードするには、アイテムのコンテンツのダウンロードの説明を参照してください。
前提条件
この API を呼び出すには、ユーザーがアプリケーションに対して、アプリが変換するファイルへの読み取りアクセス権を付与している必要があります。
HTTP 要求
GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}
オプションの要求ヘッダー
| 名前 | 値 | 説明 |
|---|---|---|
| if-none-match | String | この要求ヘッダーが含まれている場合、指定された eTag (または cTag) がファイルの現在のタグに一致すると、HTTP 304 Not Modified 応答が返されます。 |
クエリ文字列のパラメーター
| 名前 | 値 | 説明 |
|---|---|---|
| format | string | アイテムのコンテンツをダウンロードする形式を指定します。 |
形式のオプション
| 値 | 説明 | サポートされているソースの拡張子 |
|---|---|---|
| glb | アイテムを GLB 形式に変換する | cool、fbx、obj、ply、stl、3mf |
| html | アイテムを HTML 形式に変換する | eml、md、msg |
| 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 形式に変換する | doc、docx、epub、eml、htm、html、md、msg、odp、ods、odt、pps、ppsx、ppt、pptx、rtf、tif、tiff、xls、xlsm、xlsx |
例
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
エラー応答
エラーがどのように返されるかについては、「エラー応答」を参照してください。
HTML から PDF への変換に関する既知の問題
(1) 最高のパフォーマンスを得るには、HTML が XHTML 標準に準拠していることを確認してください。 このコンポーネントは、たとえばテーブルの行に終了タグがない場合など、整形式ではない HTML を正しく解析する際に、最新の Web ブラウザーほど機能しません().
(2) 状況によっては、非ラテン語文字が期待どおりにレンダリングされない場合があります。 例えば、中国語のような言語用にあらかじめ定義されたフォントのセットがインストールされていますが、HTML でよく知られているフォントが指定されていない場合、コンポーネントは使用するフォントを決定できず、文字が正しく表示されません。
(3) 各 html ファイルは A4 サイズの PDF に変換されます。 1 つの HTML 行幅が A4 サイズの幅よりも大きい場合、PDF 表示で行が切り捨てられます。