Prise en main de l’API OneDrive

  • Article

Cette page fournit un aperçu rapide des étapes nécessaires pour utiliser Microsoft Graph et l’API OneDrive. Pour une description plus détaillée, consultez la rubrique relative au démarrage rapide de Microsoft Graph.

Si vous utilisez SharePoint Server 2016 ou que vous n’utilisez pas Microsoft Graph, consultez la rubrique relative à l’utilisation de l’API OneDrive avec SharePoint Server 2016.

1. Authentification de l’utilisateur et autorisation de votre application

Microsoft Graph et l’API OneDrive utilisent OAuth 2.0 pour l’autorisation. Lors d’un flux OAuth, votre application reçoit un jeton d’accès qui procure à Microsoft Graph un ensemble d’autorisations spécifique pour un utilisateur.

Votre application indique le jeton d’accès dans chaque demande via un en-tête HTTP :

Authorization: bearer {token}

Pour plus d’informations sur l’autorisation de votre application et l’obtention d’un jeton d’accès, consultez la rubrique Autorisation de l’application avec Microsoft Graph.

2. Appeler une ressource

Une fois que votre application est autorisée et qu’elle a reçu un jeton d’accès, elle peut soumettre des demandes au point de terminaison Microsoft Graph pour les ressources OneDrive ou SharePoint. Pour construire l’URL d’une ressource, vous devez connaître l’URL correspondante pour les ressources root (par exemple, un utilisateur, un groupe ou un site), et les ressources drive ou les ressources driveItem visées par votre demande.

L’URL d’une demande inclut ces composants :

  • L’URL racine de Microsoft Graph et la version (https://graph.microsoft.com/v1.0)
  • Une cible de ressource racine (/users/{id})
  • Une cible de ressources de l’API OneDrive (/drive ou /drives/{id}/items/{item-id} ou /drive/root:/path/to/item)

Remarque : dans la documentation, seule la syntaxe partielle comme GET /drive/items/{item-id} est utilisée par souci de concision. Ajoutez un préfixe au chemin d’accès avec l’URL racine correcte et la cible de ressource root afin d’obtenir l’URL ou le chemin d’accès complet de la ressource.

3. Continuer

Consultez les exemples OneDrive sur GitHub et les exemples Microsoft Graph sur GitHub pour en savoir plus sur l’utilisation de fichiers dans Microsoft Graph.

Lisez la documentation HTTP de l’API OneDrive pour en savoir plus sur l’utilisation des ressources drive et driveItem. Pour plus d’informations sur toutes les ressources de Microsoft Graph, consultez la rubrique Documentation relative à Microsoft Graph.

Vous avez des questions ou besoin d’une assistance ? Vous pouvez nous contacter sur Stack Overflow et sur la page Problèmes GitHub pour notre documentation.