Descargar un archivo en otro formato

¿Le ha resultado útil esta página?

¿Tiene más comentarios?

Cuando presione el botón Enviar, sus comentarios se enviarán a Microsoft, que los usará para mejorar sus productos y servicios. Política de privacidad.

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

HTTP

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

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var queryOptions = new List<QueryOption>()
{
    new QueryOption("format", "{format}")
};

var stream = await graphClient.Me.Drive.Items["{driveItem-id}"].Content
    .Request( queryOptions )
    .GetAsync();

Lea la documentación del SDK para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

let stream = await client.api('/me/drive/items/{item-id}/content?format=%7Bformat%7D')
    .get();

Lea la documentación del SDK para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/drive/items/{item-id}/content?format=%7Bformat%7D"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        MSGraphStream *stream = [[MSGraphStream alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

Lea la documentación del SDK para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

LinkedList<Option> requestOptions = new LinkedList<Option>();
requestOptions.add(new QueryOption("format", "{format}"));

InputStream stream = graphClient.customRequest("/me/drive/items/{item-id}/content", InputStream.class)
    .buildRequest( requestOptions )
    .get();

Lea la documentación del SDK para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider.

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.