Скачивание файла в другом форматеDownload a file in another format

С помощью этого API вы можете получить содержимое элемента в определенном формате. Не все файлы можно преобразовать в любые форматы.Use this API to retrieve the contents of an item in a specific format. Not all files can be converted into all formats.

Сведения о том, как скачать элемент в его исходном формате, см. в статье о скачивании содержимого элемента.To download the item in it's original format, see download an item's contents.

Необходимые компонентыPrerequisites

Чтобы можно было вызвать этот API, пользователю необходимо предоставить приложению доступ на чтение к файлу, который это приложение собирается преобразовать.To call this API, the user must have granted the application read access to the file the app wishes to convert.

HTTP-запросHTTP request

GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}

Необязательные заголовки запросовOptional request headers

ИмяName ЗначениеValue ОписаниеDescription
if-none-matchif-none-match StringString Если указан этот заголовок запроса, а предоставленный тег eTag (или cTag) совпадает с текущим тегом файла, то будет возвращен ответ HTTP 304 Not Modified.If this request header is included and the eTag (or cTag) provided matches the current tag on the file, an HTTP 304 Not Modified response is returned.

Параметры строки запросаQuery string parameters

ИмяName ЗначениеValue ОписаниеDescription
formatformat строкаstring Укажите формат, в котором следует скачать содержимое элемента.Specify the format the item's content should be downloaded as.

Параметры форматированияFormat options

ЗначениеValue ОписаниеDescription Поддерживаемые расширения источникаSupported source extensions
glbglb Преобразует элемент в формат GLBConverts the item into GLB format COOL, FBX, OBJ, PLY, STL, 3MFcool, fbx, obj, ply, stl, 3mf
htmlhtml Преобразует элемент в формат HTMLConverts the item into HTML format EML, MD, MSGeml, md, msg
jpgjpg Преобразует элемент в формат JPGConverts the item into JPG format 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, YML3g2, 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
pdfpdf Преобразует элемент в формат PDFConverts the item into PDF format DOC, DOCX, EPUB, EML, HTM, HTML, MD, MSG, ODP, ODS, ODT, PPS, PPSX, PPT, PPTX, RTF, TIF, TIFF, XLS, XLSM, XLSXdoc, docx, epub, eml, htm, html, md, msg, odp, ods, odt, pps, ppsx, ppt, pptx, rtf, tif, tiff, xls, xlsm, xlsx

ПримерExample

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

ОтветResponse

Возвращает ответ 302 Found, выполняющий перенаправление на URL-адрес скачивания, прошедший предварительную аутентификацию, для преобразованного файла.Returns a 302 Found response redirecting to a pre-authenticated download URL for the converted file.

Чтобы скачать преобразованный файл, ваше приложение должно следовать заголовку Location в ответе.To download the converted file, your app must follow the Location header in the response.

URL-адреса, прошедшие предварительную аутентификацию, действуют только в течение небольшого периода времени (несколько минут) и не требуют заголовка Authorization для доступа.Pre-authenticated URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header to access.

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

Ответы с ошибкамиError responses

Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.See Error Responses for more info about how errors are returned.

Известные проблемы при преобразовании HTML в PDFKnown issues with HTML to PDF conversion

(1) Для оптимальной производительности нужно удостовериться в том, что HTML соответствует стандарту XHTML.(1) For best performance validate that the HTML follows the XHTML standard. Этот компонент не будет действовать так же, как и современные веб-браузеры, при правильном анализе HTML, который имеет неправильный формат, например, если в строке таблицы отсутствует закрывающий тег (The component will not perform as well as modern web browsers at correctly parsing HTML that is not well-formed, for example if a table row is missing an end tag ().).

(2) В некоторых случаях символы, не входящие в латиницу, не отображаются должным образом.(2) Under some circumstances non-Latin characters will not render as expected. Например, для таких языков, как китайский, используется набор готовых шрифтов, но если в HTML не указан часто используемый для компонента шрифт, при определенных обстоятельствах не удастся определить, какой шрифт нужно использовать, а сам символ не будет отображаться должным образом.For example, a set of predefined fonts are installed for languages like Chinese, but if the HTML does not specify a commonly known font the component under some circumstances will fail to determine which font to use and the character won’t be displayed properly.

(3) Каждый HTML-файл преобразовывается в PDF-файл формата A4.(3) Each html file is coverted to a A4-size PDF. Если ширина линии в формате HTML превышает ширину формата A4, в отображении PDF-файла строка будет обрезана.When a single HTML line width is greater than the A4-size width the line will be truncated in the PDF rendering.