Baixar o conteúdo de um recurso driveItemVersion

Namespace: microsoft.graph

Recupere o conteúdo de uma versão específica de um driveItem.

Observação: Não há suporte para obter o conteúdo da versão atual. Para fazer isso, use o método Baixe o conteúdo de um driveItem .

Essa API está disponível nas seguintes implantações de nuvem nacional.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Solicitação 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

Cabeçalhos de solicitação

Resposta

Retorna uma 302 Found resposta redirecionando para uma URL de download pré-autenticada para os bytes do arquivo.

Para baixar o conteúdo do arquivo, seu aplicativo precisa seguir o Location cabeçalho na resposta. Várias bibliotecas de cliente HTTP seguirão automaticamente o redirecionamento 302 e começarão a baixar imediatamente o arquivo.

As URLs de download pré-autenticadas são válidas apenas por um curto período de tempo (alguns minutos) e não exigem um Authorization cabeçalho para serem baixadas.

Exemplos

Exemplo 1: Baixar o conteúdo de uma versão anterior de um arquivo

Este exemplo recupera uma versão de um arquivo na unidade do usuário atual.

Solicitação

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 $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-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')
	.get();

<?php
use Microsoft\Graph\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.Files

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

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph 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()

Resposta

A chamada retorna um redirecionamento para onde o conteúdo da versão pode ser baixado.

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

Exemplo 2: Baixar um intervalo parcial de bytes de uma versão anterior de um arquivo

Para baixar um intervalo parcial de bytes de um driveItemVersion, seu aplicativo pode usar o Range cabeçalho conforme especificado no RFC 2616. Você deve anexar o Range cabeçalho ao seguir o redirecionamento e não à solicitação de /content.

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

A chamada retorna uma HTTP 206 Partial Content resposta com o intervalo de solicitação de bytes do arquivo. Se o intervalo não puder ser gerado, o cabeçalho poderá ser ignorado Range e uma HTTP 200 resposta será retornada com o conteúdo completo do arquivo.

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

<first 1024 bytes of file>

Comentários

O OneDrive não preserva os metadados completos para versões anteriores de um arquivo.

Quando seu aplicativo recupera a lista de versões disponíveis para um arquivo, é retornado um recurso driveItemVersion que fornece as informações disponíveis sobre a versão específica.