Descargar el contenido de un recurso driveItemVersion

Espacio de nombres: microsoft.graph

Recuperar el contenido de una versión específica de un elemento de unidad.

Nota: No se admite la obtención del contenido de la versión actual. En su lugar, usa el punto de conexión de contenido driveItem.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Solicitud HTTP

GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
GET /groups/{group-id}/drive/items/{item-id}/versions/{version-id}/content
GET /me/drive/items/{item-id}/versions/{version-id}/content
GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id}/content
GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content

Respuesta

Devuelve una 302 Found respuesta que redirige a una dirección URL de descarga autenticada previamente para los bytes del archivo.

Para descargar el contenido del archivo, la aplicación debe seguir el encabezado de Location la respuesta. Muchas bibliotecas de cliente HTTP seguirán de forma automática el redireccionamiento 302 e iniciarán la descarga del archivo de forma inmediata.

Las direcciones URL de descarga autenticadas previamente solo son válidas durante un breve período de tiempo (unos minutos) y no requieren un Authorization encabezado para descargarse.

Ejemplos

Ejemplo 1: Descargar el contenido de una versión anterior de un archivo

Este ejemplo recupera una versión de un archivo en la unidad del usuario actual.

Solicitud

GET /me/drive/items/{item-id}/versions/{version-id}/content

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Versions["{driveItemVersion-id}"].Content.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Versions().ByDriveItemVersionId("driveItemVersion-id").Content().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").versions().byDriveItemVersionId("{driveItemVersion-id}").content().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/me/drive/items/{item-id}/versions/{version-id}/content')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->versions()->byDriveItemVersionId('driveItemVersion-id')->content()->get()->wait();

Import-Module Microsoft.Graph.Beta.Files

Get-MgBetaDriveItemVersionContent -DriveId $driveId -DriveItemId $driveItemId -DriveItemVersionId $driveItemVersionId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').versions.by_drive_item_version_id('driveItemVersion-id').content.get()

Respuesta

Devuelve una redirección a donde se puede descargar el contenido de la versión.

HTTP/1.1 302 Redirect
Location: https://onedrive.com/34FF49D6...

Ejemplo 2: Descargar un intervalo parcial de bytes de una versión anterior de un archivo

Para descargar un intervalo parcial de bytes de un elemento driveItemVersion, la aplicación puede usar el Range encabezado especificado en RFC 2616. Debe anexar el Range encabezado cuando siga la redirección y no a la solicitud de /content.

GET https://onedrive.com/34FF49D6...
Range: bytes=0-1023

La llamada devuelve una HTTP 206 Partial Content respuesta con el intervalo de solicitudes de bytes del archivo. Si no se puede generar el intervalo, se puede ignorar el Range encabezado y se devolverá una HTTP 200 respuesta con el contenido completo del archivo.

HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/2048

<first 1024 bytes of file>

Comentarios

OneDrive no conserva los metadatos completos de las versiones anteriores de un archivo.

Cuando la aplicación recupera la lista de versiones disponibles de un archivo, se devuelve un recurso driveItemVersion que proporciona la información disponible sobre la versión específica.