Descargar un archivo en otro formatoDownload a file in another format

• 09/10/2017
• Tiempo de lectura: 2 minutos
• • 
  • 

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

Opciones de formatoFormat options

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

Encabezados de solicitud opcionalesOptional request headers

EjemploExample

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

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

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

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

const options = {
    authProvider,
};

const client = Client.init(options);

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

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];

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

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

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

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.