Télécharger le contenu d’une ressource driveItemVersion

Espace de noms: microsoft.graph

Récupérer le contenu d’une version spécifique d’un élément de lecteur.

Remarque : L’obtention du contenu de la version actuelle n’est pas prise en charge. Utilisez plutôt le point de terminaison de contenu driveItem.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Requête 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

Réponse

Renvoie une 302 Found réponse redirigeant vers une URL de téléchargement préauthentifiée pour les octets du fichier.

Pour télécharger le contenu du fichier, votre application doit suivre l’en-tête Location dans la réponse. De nombreuses bibliothèques de client HTTP suivront automatiquement la redirection 302 et commenceront à télécharger le fichier immédiatement.

Les URL de téléchargement préauthentifiées ne sont valides que pendant une courte période (quelques minutes) et ne nécessitent pas d’en-tête Authorization pour être téléchargées.

Exemples

Exemple 1 : Télécharger le contenu d’une version antérieure d’un fichier

Cet exemple récupère la version d’un fichier dans le lecteur de l’utilisateur actuel.

Demande

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()

Réponse

Renvoie une redirection vers l’emplacement où le contenu de la version peut être téléchargé.

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

Exemple 2 : télécharger une plage partielle d’octets à partir d’une version antérieure d’un fichier

Pour télécharger une plage partielle d’octets à partir d’un driveItemVersion, votre application peut utiliser l’en-tête comme spécifié dans RFC Range2616. Vous devez ajouter l’en-tête Range lorsque vous suivez la redirection et non à la demande de /content.

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

L’appel retourne une HTTP 206 Partial Content réponse avec la plage d’octets de demande du fichier. Si la plage ne peut pas être générée, l’en-tête Range peut être ignoré et une HTTP 200 réponse sera renvoyée avec le contenu complet du fichier.

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

<first 1024 bytes of file>

Remarques

OneDrive ne conserve pas les métadonnées complètes des versions antérieures d’un fichier.

Lorsque votre application récupère la liste des versions disponibles pour un fichier, une ressource driveItemVersion est renvoyée qui fournit les informations disponibles sur la version spécifique.