Descargar un archivo en otro formatoDownload a file in another format

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Use esta API para recuperar el contenido de un elemento en un formato determinado.Use this API to retrieve the contents of an item in a specific format. No todos los archivos pueden convertirse a todos los formatos.Not all files can be converted into all formats.

Para descargar el elemento en su formato original, vea descargar el contenido de un elemento.To download the item in its original format, see download an item's contents.

Requisitos previosPrerequisites

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.To call this API, the user must have granted the application read access to the file the app wishes to convert.

Solicitud HTTPHTTP request

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

Parámetros de consultaQuery parameters

ParámetroParameter TipoType DescripciónDescription
formatformat stringstring Especifique el formato en el que debe descargarse el contenido del elemento.Specify the format the item's content should be downloaded as.

Opciones de formatoFormat options

Los siguientes valores son válidos para el parámetro format:The following values are valid for the format parameter:

Valor de formatoFormat value DescripciónDescription Extensiones de origen compatiblesSupported source extensions
pdfpdf Convierte el elemento en formato PDF.Converts the item into PDF format. csv, doc, docx, odp, ods, odt, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, rtf, xls, xlsxcsv, doc, docx, odp, ods, odt, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, rtf, xls, xlsx

Encabezados de solicitud opcionalesOptional request headers

NombreName ValorValue DescripciónDescription
if-none-matchif-none-match StringString 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.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.

EjemploExample

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

RespuestaResponse

Devuelve una respuesta 302 Found que redirige a una dirección URL de descarga autenticada previamente para el archivo convertido.Returns a 302 Found response redirecting to a pre-authenticated download URL for the converted file.

Para descargar el archivo convertido, la aplicación debe seguir el encabezado Location de la respuesta.To download the converted file, your app must follow the Location header in the response.

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.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

Respuestas de errorError responses

Vea Respuestas de error para obtener más información sobre la manera en que se devuelven los errores.See Error Responses for more information about how errors are returned.