Verwenden der OneNote-REST-APIUse the OneNote REST API

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

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.Microsoft Graph lets your app get authorized access to a user's Outlook mail data in a personal or organization account. 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.With the appropriate delegated or application permissions, your app can access the OneNote data of the signed-in user or any user in a tenant.

Stamm-URLRoot URL

Die Stamm-URL des OneNote-Diensts verwendet das folgende Format für alle Aufrufe der OneNote-API.The OneNote service root URL uses the following format for all calls to the 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:The version segment in the URL represents the version of Microsoft Graph that you want to use.

  • Setzen Sie v1.0 für stabilen Produktionscode.v1.0 is for stable production code.
  • Setzen Sie beta, wenn Sie ein Feature testen möchten, das sich noch in der Entwicklung befindet.beta is to try out a feature that's in development. Features und Funktionen im Beta-Endpunkt können geändert werden. Es wird davon abgeraten, sie in Produktionscode zu verwenden.Features and functionality in the beta endpoint might change; we don't recommend that you use it in your production code.

Speicherort können Benutzernotizbücher in Office 365 oder dem Verbraucher-OneDrive, Gruppennotizbücher oder auf einer SharePoint-Website gehostete Teamnotizbücher in Office 365 sein.The location can be user notebooks on Office 365 or consumer OneDrive, group notebooks, or SharePoint site-hosted team notebooks on Office 365.

OneNote-API-Entwicklungsstapel

BenutzernotizbücherUser notebooks

Verwenden Sie einen der folgenden URLs, um auf persönliche Notizbücher im OneDrive-Consumerdienst oder in OneDrive for Business zuzugreifen:To access personal notebooks on consumer OneDrive or OneDrive for Business, use one of the following URLs:

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).me is for OneNote content that the current user can access (owned and shared).
  • Setzen Sie users/{id} für OneNote-Inhalte, die der (in der URL) angegebene Benutzer für den aktuellen Benutzer freigegeben hat.users/{id} is for OneNote content that the specified user (in the URL) has shared with the current user. Verwenden der Benutzer-API.Use the Windows API

Hinweis: Benutzer-IDs können Sie über eine GET-Anforderung an https://graph.microsoft.com/v1.0/users abrufen.Note: You can get user ids by making a GET request on https://graph.microsoft.com/v1.0/users.

GruppennotizbücherGroup notebooks

Verwenden Sie die folgende Dienststamm-URL, um auf Notizbücher zuzugreifen, die im Besitz einer Gruppe sind:To access notebooks that are owned by a group, use the following service root URL:

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

SharePoint-Website-NotizbücherSharePoint site notebooks

Verwenden Sie die folgende Dienststamm-URL, um auf Notizbücher zuzugreifen, die einer SharePoint-Teamwebsite gehören:To access notebooks that are owned by a SharePoint team site, use the following service root URL:

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