Verwenden der OneNote-REST-API

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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, wenn Sie ein Feature testen möchten, das sich noch in der Entwicklung befindet. Features und Funktionen im Beta-Endpunkt können geändert werden. Es wird davon abgeraten, sie in 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.

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 der Benutzer-API.

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}