Baixar um arquivo em outro formato
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.
Para baixar o item no formato original, confira Baixar o conteúdo de um item.
Pré-requisitos
Para chamar esta API, o usuário deve ter concedido acesso de leitura ao aplicativo para o arquivo que o aplicativo deseja converter.
Solicitação HTTP
GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}
Cabeçalhos de solicitação opcionais
| Nome | Valor | Descrição |
|---|---|---|
| if-none-match | String | 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. |
Parâmetros de cadeia de caracteres de consulta
| Name | Valor | Descrição |
|---|---|---|
| format | string | Especifique o formato em que o conteúdo do item deve ser baixado. |
Opções de formato
| Valor | Descrição | Extensões de origem com suporte |
|---|---|---|
| glb | Converte o item ao formato GLB | cool, fbx, obj, ply, stl, 3mf |
| HTML | Converte o item ao formato HTML | eml, md, msg |
| jpg | Converte o item ao formato 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 |
| Converte o item ao formato PDF | doc, docx, epub, eml, htm, html, md, msg, odp, ods, odt, pps, ppsx, ppt, pptx, rtf, tif, tiff, xls, xlsm, xlsx |
Exemplo
GET /drive/items/{item-id}/content?format={format}
Resposta
Retorna uma resposta 302 Found que redireciona para uma URL de download previamente autenticada do arquivo convertido.
Para baixar o arquivo convertido, seu aplicativo deve seguir o cabeçalho Location na resposta.
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.
HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi
Respostas de erros
Confira mais informações sobre como os erros são retornados em Respostas de Erros.
Problemas conhecidos com a conversão HTML para PDF
(1) para obter um melhor desempenho, valide se o HTML acompanha o padrão XHTML. 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 ().
(2) em algumas circunstâncias, os caracteres não latinos não serão renderizados conforme o esperado. 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.
(3) cada arquivo HTML é desviado para um PDF de tamanho A4. Quando uma única largura de linha HTML for maior que a largura de tamanho A4, a linha será truncada na renderização de PDF.