Charger un élément vers OneDrive à partir d’une URL (pré-version)

  • Article

Votre application peut charger un élément vers OneDrive à l’aide d’une URL. OneDrive télécharge directement le fichier à partir d’un serveur distant, de telle sorte que votre application n’a pas à charger les octets du fichier. Ceci s’avère particulièrement utile pour les clients mobiles ou les compléments de navigateurs, pour lesquels le contenu du fichier n’est pas disponible ou est coûteux à transférer.

Pour charger des fichiers volumineux, consultez cette rubrique.

Remarque : vous pouvez uniquement charger des éléments à partir d’une URL vers OneDrive Personnel.

Autorisations

L’une des autorisations suivantes est requise 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 plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) s/o
Déléguée (compte Microsoft personnel) Files.ReadWrite, Files.ReadWrite.All
Application s/o

Requête HTTP

POST /me/drive/items/{parent-item}/children

En-têtes de demande

Nom Type Description
Prefer chaîne Utilisez la valeur respond-async pour activer le transfert d’élément asynchrone. Sinon, la demande est abandonnée.

Corps de la demande

Le contenu du corps de la demande doit être la représentation JSON de l’élément à créer à partir de l’URL distante. Quand le service télécharge le fichier à partir de l’URL distante, il n’est pas authentifié en tant qu’utilisateur. L’URL doit donc être accessible au public.

Réponse

Cette méthode renvoie des détails sur la manière de suivre la progression du téléchargement, quand la demande est acceptée.

HTTP/1.1 202 Accepted
Location: https://api.onedrive.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Exemple

POST /drive/items/{parent-item}/children
Content-Type: application/json
Prefer: respond-async

{
  "@microsoft.graph.sourceUrl": "http://wscont2.apps.microsoft.com/winstore/1x/e33e38d9-d138-42a1-b252-27da1924ca87/Screenshot.225037.100000.jpg",
  "name": "halo-screenshot.jpg",
  "file": { }
}

Réponse

Le service est réactivé dès que la demande a été acceptée et fournit des détails sur la façon de surveiller l’avancement de la copie.

HTTP/1.1 202 Accepted
Location: https://api.onedrive.com/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

La valeur de l’en-tête Location fournit une URL qui peut être utilisée pour obtenir l’état actuel de l’opération et vous faire savoir que le chargement est terminé.

Remarques

Le chargement d’un élément vers OneDrive Entreprise, SharePoint Online et SharePoint Server 2016 à l’aide d’une URL n’est pas pris en charge.