Descargar un archivo en otro formato
Espacio de nombres: microsoft.graph
Advertencia
Este extremo requiere TLS 1.2 para funcionar normalmente. Microsoft anunció el desuso de TLS 1.0 y 1.1 para Office 365 y Azure AD servicios. Aunque Microsoft Graph admite estos dos protocolos, es posible que experimente errores de nivel de transporte. Para obtener más información acerca de la desuso de TLS 1.0 y 1.1, vea Enable support for TLS 1.2 in your environment.
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.
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All |
Aplicación | Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Solicitud HTTP
GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}
Parámetros de consulta
Parámetro | Tipo | Descripción |
---|---|---|
format | string | Especifique el formato en el que debe descargarse el contenido del elemento. |
Opciones de formato
Los siguientes valores son válidos para el parámetro format:
Valor de formato | Descripción | Extensiones de origen compatibles |
---|---|---|
Convierte el elemento en formato PDF. | csv, doc, docx, odp, ods, odt, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, rtf, xls, xlsx |
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 . |
Ejemplo
GET /me/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.
Comentarios
Enviar y ver comentarios de