Utilisation de l’API REST OneNote

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

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 cours de 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.

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é).
• users/{id} est 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}