Descargar un archivo en otro formato
Use esta API para recuperar el contenido de un elemento en un formato determinado. No todos los archivos pueden convertirse a todos los formatos.
Para descargar el elemento en su formato original, vea descargar el contenido de un elemento.
Requisitos previos
Para llamar a esta API, al usuario se le debe haber concedido el acceso de lectura de la aplicación al archivo que la aplicación quiere convertir.
Solicitud HTTP
GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}
Encabezados de solicitud opcionales
| Nombre | Valor | Descripción |
|---|---|---|
| if-none-match | String | Si se incluye el encabezado de la solicitud y la eTag (o cTag) proporcionada coincide con la etiqueta actual del archivo, se devuelve una respuesta HTTP 304 Not Modified. |
Parámetros de la cadena de consulta
| Nombre | Valor | Descripción |
|---|---|---|
| format | string | Especifique el formato en el que debe descargarse el contenido del elemento. |
Opciones de formato
| Valor | Descripción | Extensiones de origen compatibles |
|---|---|---|
| glb | Convierte el elemento en formato GLB. | cool, fbx, obj, ply, stl, 3mf |
| html | Convierte el elemento en formato HTML. | eml, md, msg |
| jpg | Convierte el elemento en 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 |
| Convierte el elemento en formato PDF. | doc, docx, epub, eml, htm, html, md, msg, odp, ods, odt, pps, ppsx, ppt, pptx, rtf, tif, tiff, xls, xlsm, xlsx |
Ejemplo
GET /drive/items/{item-id}/content?format={format}
Respuesta
Devuelve una respuesta 302 Found que redirige a una dirección URL de descarga autenticada previamente para el archivo convertido.
Para descargar el archivo convertido, la aplicación debe seguir el encabezado Location de la respuesta.
Las URL autenticadas previamente solo son válidas durante un breve período de tiempo (unos minutos) y no requieren un encabezado Authorization para tener acceso a ellas.
HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi
Respuestas de error
Vea Respuestas de error para obtener más información sobre la manera en que se devuelven los errores.
Problemas conocidos relacionados con la conversión de HTML a PDF
(1) Para obtener el mejor rendimiento posible, valide que el código HTML sigue el estándar XHTML. El rendimiento del componente será peor que el los exploradores web modernos a la hora de analizar correctamente código HTML que no tenga un formato correcto, por ejemplo, si en una fila de tabla falta una etiqueta de cierre ().
(2) En algunas circunstancias, los caracteres que no sean latinos no se representarán de la forma esperada. Por ejemplo, un conjunto de fuentes predefinidas se instalan para idiomas como el chino, pero si el código HTML no especifica una fuente conocida comúnmente, en ciertas circunstancias el componente no podrá determinar qué fuente usar y el carácter no se mostrará correctamente.
(3) Cada archivo HTML se convierte en un PDF de tamaño A4. Cuando un único ancho de línea de HTML sea mayor que el ancho de tamaño A4, la línea se truncará en el procesamiento del PDF.