Télécharger le contenu du driveItem

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Téléchargez le contenu du flux principal (fichier) d’une ressource driveItem. Seuls les objets driveItem avec la propriété de fichier peuvent être téléchargés.

Pour obtenir l’ID de l’élément à télécharger, consultez Obtenir l’élément de lecteur.

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

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ✅

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.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
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

Remarque

SharePoint Embedded nécessite l’autorisation FileStorageContainer.Selected pour accéder au contenu du conteneur. Cette autorisation est différente de celles mentionnées précédemment. Outre les autorisations Microsoft Graph, votre application doit disposer des autorisations de type conteneur nécessaires pour appeler cette API. Pour plus d’informations, consultez Authentification et autorisation SharePoint Embedded.

Requête HTTP

GET /drives/{drive-id}/items/{item-id}/content
GET /groups/{group-id}/drive/items/{item-id}/content
GET /me/drive/root:/{item-path}:/content
GET /me/drive/items/{item-id}/content
GET /shares/{shareIdOrEncodedSharingUrl}/driveItem/content
GET /sites/{siteId}/drive/items/{item-id}/content
GET /users/{userId}/drive/items/{item-id}/content

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
If-None-Match Si cet en-tête de demande est inclus et que l’eTag (ou cTag) fourni correspond à l’identité actuelle sur le fichier, une réponse HTTP 304 Not Modified est renvoyée. Facultatif.
Préférer : forceInfectedDownload Si elle est fournie, la demande peut télécharger un fichier infecté. Pour les demandes déléguées, si le paramètre de locataire DisallowInfectedFileDownload est activé, seuls les administrateurs de client ou les administrateurs généraux peuvent télécharger le fichier. Les demandes d’application uniquement téléchargent un fichier infecté, quels que soient les paramètres du locataire. Facultatif.

Exemple

L’exemple suivant montre une demande de téléchargement d’un fichier complet.

Demande

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

Réponse

L’exemple suivant illustre la réponse.

Renvoie une 302 Found réponse redirigeant vers une URL de téléchargement préauthentifiée pour le fichier. Il s’agit de la même URL disponible via la @microsoft.graph.downloadUrl propriété sur le DriveItem.

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 clientes HTTP suivent la redirection 302 et commencent à 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.

HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi

Téléchargement de fichiers dans les applications JavaScript

Pour télécharger des fichiers dans une application JavaScript, vous ne pouvez pas utiliser l’API /content , car elle répond par une 302 redirection. Une 302 redirection est explicitement interdite lorsqu’un contrôle en amontdu partage des ressources cross-origin (CORS) est requis, par exemple lors de la fourniture de l’en-tête Authorization.

Au lieu de cela, votre application doit sélectionner la propriété @microsoft.graph.downloadUrl, qui renvoie la même URL vers laquelle /content dirige. Cette URL peut ensuite être demandée directement à l’aide de XMLHttpRequest. Étant donné que ces URL sont pré-authentifiées, elles peuvent être récupérées sans demande de contrôle en amont CORS.

Exemple

Pour récupérer l’URL de téléchargement d’un fichier, émettez tout d’abord une requête qui inclut la propriété @microsoft.graph.downloadUrl :

GET /drive/items/{item-ID}?select=id,@microsoft.graph.downloadUrl

L’appel retourne l’ID et l’URL de téléchargement d’un fichier :

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "12319191!11919",
  "@microsoft.graph.downloadUrl": "https://..."
}

Vous pouvez ensuite émettre une requête XMLHttpRequest pour obtenir l’URL fournie dans @microsoft.graph.downloadUrl pour extraire le fichier.

Téléchargements de plage partielle

Pour télécharger une plage partielle d’octets à partir du fichier, votre application peut utiliser l’en-tête Range comme spécifié dans RFC 2616. Vous devez ajouter l’en-tête Range à l’URL réelle @microsoft.graph.downloadUrl et non à la demande de /content.

GET https://b0mpua-by3301.files.1drv.com/y23vmag
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>

Réponses d’erreur

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, consultez Réponses d’erreur .