以其他格式下载文件
使用此 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}
响应
返回 302 Found 响应，重定向到已转换文件的已预先验证的下载 URL。
应用必须遵循响应中的 Location 头，才能下载已转换的文件。
已预先验证的 URL 仅在短期（几分钟）内有效，无需 Authorization 头即可访问。
HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi
错误响应
请参阅错误响应，详细了解错误返回方式。
已知的从HTML到PDF转换问题
（1）为获得最佳性能，请验证 HTML 是否遵循 XHTML 标准。 该组件在正确解析格式不完善的HTML方面的表现将不如现代网络浏览器，例如，如果表格行缺少一个结束标签（).
（2）在某些情况下，非拉丁字符将无法按预期呈现。 例如，为中文等语言安装了一组预定义的字体，但如果HTML未指定常用的字体，则该组件在某些情况下将无法确定使用哪种字体，从而无法正确显示字符。
（3）每个 html 文件到将由 A4 尺寸的 PDF覆盖。 当单个HTML行的宽度大于A4尺寸的宽度时，将截断在PDF渲染中的该行。