Utilisation de l’API REST OneNote

Microsoft Graph permet à votre application d’obtenir un accès autorisé aux pages, sections et blocs-notes OneNote d’un utilisateur dans un compte personnel ou professionnel. Avec les autorisations déléguées ou d'application appropriées, votre application peut accéder aux données OneNote de l’utilisateur connecté ou de tout utilisateur chez un client.

URL racine

L’URL racine du service OneNote utilise le format suivant pour tous les appels à OneNote API.

https://graph.microsoft.com/{version}/{location}/onenote/ 

Le segment version de l’URL représente la version de Microsoft Graph que vous souhaitez utiliser :

  • Utilisez v1.0 pour le code de production stable.
  • Utilisez beta pour tester une fonctionnalité en développement. Les fonctions et fonctionnalités du point de terminaison bêta peuvent changer. Nous vous déconseillons de l’utiliser dans votre code de production.

L’emplacement peut être un bloc-notes utilisateur dans Microsoft 365 ou OneDrive grand public, un bloc-notes de groupe ou un bloc-notes d’équipe hébergé sur un site SharePoint dans Microsoft 365.

Pile de développement de l’API OneNote

Blocs-notes utilisateur

Pour accéder aux blocs-notes personnels sur OneDrive grand public ou OneDrive Entreprise, utilisez l’une des URL suivantes :

https://graph.microsoft.com/{version}/me/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{userPrincipalName}/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{id}/onenote/{notebooks | sections | sectionGroups | pages} 
  • Utilisez me pour le contenu OneNote auquel l’utilisateur actuel peut accéder (contenu propriétaire et partagé).
  • Utilisez users/{id} pour le contenu OneNote que l’utilisateur spécifié (dans l’URL) a partagé avec l’utilisateur actuel. Utilisez l’API utilisateurs.

Remarque : vous pouvez obtenir les identifiants utilisateur en effectuant une requête GET sur https://graph.microsoft.com/v1.0/users.

Blocs-notes de groupe

Pour accéder aux blocs-notes appartenant à un groupe, utilisez l’URL racine de service suivante :

https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Blocs-notes de site SharePoint

Pour accéder aux blocs-notes appartenant à un site d’équipe SharePoint, utilisez l’URL racine de service suivante :

https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Nouveautés

Pour en savoir plus sur le les dernières nouveautés et mises à jour pour cet ensemble d'API.