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

  • Article
  • 2 minutes de lecture

Découvrez comment récupérer le contenu d’une version spécifique d’une ressource DriveItem.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le moins de privilèges à celle qui en offre le plus)
Déléguée (compte professionnel ou scolaire) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Application Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
GET /groups/{group-id}/drive/{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 réponse 302 Found qui redirige vers une URL de téléchargement préalablement authentifiée pour récupérer 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éalablement authentifiées ne sont valides que pour une courte période de temps (quelques minutes) et ne nécessitent pas d’en-tête Authorization pour le téléchargement.

Exemple

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

Requête HTTP

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

Réponse

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

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

Remarques

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

Quand votre application récupère la liste des versions disponibles d’un fichier, une ressource DriveItemVersion est renvoyée pour fournir les informations disponibles sur la version spécifique.