Baixar um arquivo em outro formatoDownload a file in another format

Use esta API para recuperar os conteúdos de um item em um formato específico. Nem todos os arquivos podem ser convertidos em todos os formatos.Use this API to retrieve the contents of an item in a specific format. Not all files can be converted into all formats.

Para baixar o item no formato original, confira Baixar o conteúdo de um item.To download the item in it's original format, see download an item's contents.

Pré-requisitosPrerequisites

Para chamar esta API, o usuário deve ter concedido acesso de leitura ao aplicativo para o arquivo que o aplicativo deseja converter.To call this API, the user must have granted the application read access to the file the app wishes to convert.

Solicitação HTTPHTTP request

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

Cabeçalhos de solicitação opcionaisOptional request headers

NomeName ValorValue DescriçãoDescription
if-none-matchif-none-match StringString Se este cabeçalho de solicitação estiver incluso e a eTag (ou cTag) fornecida corresponder à marca atual do arquivo, uma resposta HTTP 304 Not Modified será exibida.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.

Parâmetros de cadeia de caracteres de consultaQuery string parameters

NameName ValorValue DescriçãoDescription
formatformat stringstring Especifique o formato em que o conteúdo do item deve ser baixado.Specify the format the item's content should be downloaded as.

Opções de formatoFormat options

ValorValue DescriçãoDescription Extensões de origem com suporteSupported source extensions
glbglb Converte o item ao formato GLBConverts the item into GLB format cool, fbx, obj, ply, stl, 3mfcool, fbx, obj, ply, stl, 3mf
HTMLhtml Converte o item ao formato HTMLConverts the item into HTML format eml, md, msgeml, md, msg
jpgjpg Converte o item ao formato 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 Converte o item ao formato 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

ExemploExample

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

RespostaResponse

Retorna uma resposta 302 Found que redireciona para uma URL de download previamente autenticada do arquivo convertido.Returns a 302 Found response redirecting to a pre-authenticated download URL for the converted file.

Para baixar o arquivo convertido, seu aplicativo deve seguir o cabeçalho Location na resposta.To download the converted file, your app must follow the Location header in the response.

As URLs de download previamente autenticadas são válidas apenas por um curto período de tempo (alguns minutos) e não exigem um cabeçalho Authorization para download.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

Respostas de errosError responses

Confira mais informações sobre como os erros são retornados em Respostas de Erros.See Error Responses for more info about how errors are returned.

Problemas conhecidos com a conversão HTML para PDFKnown issues with HTML to PDF conversion

(1) para obter um melhor desempenho, valide se o HTML acompanha o padrão XHTML.(1) For best performance validate that the HTML follows the XHTML standard. O componente não executa o, bem como navegadores modernos na análise de HTML corretamente, que não é bem formado, por exemplo, se uma linha de tabela não tiver uma marca de fim (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) em algumas circunstâncias, os caracteres não latinos não serão renderizados conforme o esperado.(2) Under some circumstances non-Latin characters will not render as expected. Por exemplo, um conjunto de fontes predefinidas é instalado para idiomas como chinês, mas se o HTML não especificar uma fonte comumente conhecida, o componente em algumas circunstâncias falhará ao determinar qual fonte usar e o caractere não será exibido corretamente.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) cada arquivo HTML é desviado para um PDF de tamanho A4.(3) Each html file is coverted to a A4-size PDF. Quando uma única largura de linha HTML for maior que a largura de tamanho A4, a linha será truncada na renderização de PDF.When a single HTML line width is greater than the A4-size width the line will be truncated in the PDF rendering.