Verwenden der OneNote-REST-APIUse the OneNote REST API

Microsoft Graph können Ihre app autorisierten Zugriff auf eines Benutzers OneNote-Notizbücher, Abschnitte und Seiten in einem persönlichen oder Organisation Konto zu erhalten.Microsoft Graph lets your app get authorized access to a user's OneNote notebooks, sections, and pages in a personal or organization account. Mit den entsprechenden Berechtigungen für delegierte oder Anwendungkann Ihre app die OneNote-Daten des angemeldeten Benutzers oder jeder Benutzer 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/ 

Die version Segment in der URL darstellt, die Version von Microsoft Graph, die Sie verwenden möchten: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 in der Beta-Endpunkt möglicherweise ändern. Es wird nicht empfohlen, für die Verwendung in Ihrem Produktionscode.Features and functionality in the beta endpoint might change; we don't recommend that you use it in your production code.

Der Speicherort kann Benutzer Notizbücher auf Office 365 oder Consumer OneDrive, Gruppe Notebooks oder SharePoint-Website gehosteten Team Notizbücher auf 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-Entwicklung Stapel

Benutzer-NotizbüchernUser notebooks

Verwenden Sie den Zugriff auf persönliche Notizbücher auf Consumer OneDrive oder OneDrive für Unternehmen eine der folgenden URLs: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 Sie die Benutzer API.Use the users API.

Hinweis: Sie können die Benutzer-IDs abrufen, indem Sie tätigen eine GET-Anforderung auf https://graph.microsoft.com/v1.0/users.Note: You can get user IDs by making a GET request on https://graph.microsoft.com/v1.0/users.

Gruppe-NotizbüchernGroup notebooks

Um Notizbücher zugreifen, die eine Gruppe gehören, verwenden Sie die folgenden dienststamm-URL: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üchernSharePoint site notebooks

Um Notizbücher zugreifen, die SharePoint-Teamwebsite gehören, verwenden Sie die folgenden dienststamm-URL: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}