Utilisation de l’API REST OneNote

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 .

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 ou les autorisations d’application appropriées, votre application peut accéder aux données OneNote de l’utilisateur connecté ou de tout 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.

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é).
  • 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}