Использование REST API для OneNoteUse the OneNote REST API

Microsoft Graph позволяет вашему приложению получать авторизованный доступ к записным книжкам, разделам и страницам OneNote в личной или организационной учетной записи.Microsoft Graph lets your app get authorized access to a user's OneNote notebooks, sections, and pages in a personal or organization account. Имея соответствующие разрешения приложения или делегированные разрешения, приложение может получать доступ к данным OneNote вошедшего пользователя или любого пользователя в клиенте.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.

Корневой URL-адресRoot URL

Для всех вызовов API OneNote используется следующий формат корневого URL-адреса службы OneNote.The OneNote service root URL uses the following format for all calls to the OneNote API.

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

Сегмент version URL-адреса представляет нужную версию Microsoft Graph.The version segment in the URL represents the version of Microsoft Graph that you want to use:

  • Значение v1.0 предназначено для стабильного производственного кода.v1.0 is for stable production code.
  • Используйте значение beta, чтобы опробовать функцию, находящуюся на стадии разработки.beta is to try out a feature that's in development. Функции бета-версии конечной точки могут меняться. Не рекомендуем использовать ее в рабочем коде.Features and functionality in the beta endpoint might change; we don't recommend that you use it in your production code.

В качестве расположений можно задавать записные книжки пользователя в Office 365 или личные хранилища OneDrive, записные книжки группы (в том числе размещенные на сайте SharePoint) в Office 365.The location can be user notebooks on Office 365 or consumer OneDrive, group notebooks, or SharePoint site-hosted team notebooks on Office 365.

Стек разработки API OneNote

Записные книжки пользователейUser notebooks

Чтобы получить доступ к персональным записным книжкам в OneDrive для бизнеса или личном хранилище OneDrive, воспользуйтесь одним из следующих URL-адресов: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} 
  • Значение me предназначено для содержимого OneNote, доступного текущему пользователю (если он является владельцем или с ним поделились этим содержимым).me is for OneNote content that the current user can access (owned and shared).
  • Значение users/{id} предназначено для содержимого OneNote, которым указанный (в URL-адресе) пользователь поделился с текущим пользователем.users/{id} is for OneNote content that the specified user (in the URL) has shared with the current user. Используйте API для работы с пользователями.Use the users API.

Примечание. Вы можете получить идентификаторы пользователей, отправив запрос GET к конечной точке 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.

Записные книжки группыGroup notebooks

Чтобы получить доступ к записным книжкам группы, воспользуйтесь следующим корневым 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} 

Записные книжки на сайте SharePointSharePoint site notebooks

Чтобы получить доступ к записным книжкам на сайте группы SharePoint, воспользуйтесь следующим корневым 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}