Verwenden der OneNote-REST-API

Mit Microsoft Graph kann Ihre App autorisierten Zugriff auf die OneNote-Notizbücher, -Abschnitte und -Seiten eines Benutzers in einem persönlichen oder Organisationskonto erhalten. Mit den entsprechenden delegierten Berechtigungen oder Anwendungsberechtigungen kann die App auf die OneNote-Daten des angemeldeten Benutzers oder eines beliebigen Benutzers in einem Mandanten zugreifen.

Stamm-URL

Die Stamm-URL des OneNote-Diensts verwendet das folgende Format für alle Aufrufe der OneNote-API.

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

Das Segment version in der URL ist die Version von Microsoft Graph, die verwendet werden soll:

  • Setzen Sie v1.0 für stabilen Produktionscode.
  • Setzen Sie beta, um ein Feature zu testen, dass sich noch in der Entwicklung befindet. Features und Funktionen im Beta-Endpunkt können geändert werden. Es wird davon abgeraten, sie im Produktionscode zu verwenden.

Dabei kann es sich um Benutzer-Notebooks auf Microsoft 365 oder um OneDrive-Notebooks für Verbraucher, Gruppen-Notebooks oder Team-Notebooks mit SharePoint-Hosting auf Microsoft 365 handeln.

OneNote-API-Entwicklungsstapel

Benutzernotizbücher

Verwenden Sie einen der folgenden URLs, um auf persönliche Notizbücher im OneDrive-Consumerdienst oder in OneDrive for Business zuzugreifen:

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} 
  • Setzen Sie me für OneNote-Inhalte, auf die der aktuelle Benutzer zugreifen kann (eigene und freigegebene Inhalte).
  • Setzen Sie users/{id} für OneNote-Inhalte, die der (in der URL) angegebene Benutzer für den aktuellen Benutzer freigegeben hat. Verwenden Sie die API des Benutzers.

Hinweis: Benutzer-IDs können Sie über eine GET-Anforderung an https://graph.microsoft.com/v1.0/users abrufen.

Gruppennotizbücher

Verwenden Sie die folgende Dienststamm-URL, um auf Notizbücher zuzugreifen, die im Besitz einer Gruppe sind:

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

SharePoint-Website-Notizbücher

Verwenden Sie die folgende Dienststamm-URL, um auf Notizbücher zuzugreifen, die einer SharePoint-Teamwebsite gehören:

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

Neuerungen

Informieren Sie sich über die aktuellsten neuen Features und Updates für diesen API-Satz.