Verwenden der OneNote-REST-API

  • Artikel

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.

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 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}