Скачивание файла в другом формате
С помощью этого 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 | строка | Укажите формат, в котором следует скачать содержимое элемента. |
Параметры форматирования
| Значение | Описание | Поддерживаемые расширения источника |
|---|---|---|
| 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-файл преобразовывается в PDF-файл формата A4. Если ширина линии в формате HTML превышает ширину формата A4, в отображении PDF-файла строка будет обрезана.