Тип ресурса onenote

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Точка входа для ресурсов OneNote.

Все вызовы службы OneNote через API Microsoft Graph выполняются с помощью следующего корневого URL-адреса службы:

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

В качестве расположений можно задавать записные книжки пользователя в Microsoft 365 или личные хранилища OneDrive, записные книжки группы (в том числе размещенные на сайте SharePoint) в Microsoft 365.

Записные книжки пользователей. Чтобы получить доступ к персональным записным книжкам в OneDrive для бизнеса или личном хранилище OneDrive, воспользуйтесь одним из следующих URL-адресов:

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} 

Записные книжки группы. Чтобы получить доступ к записным книжкам группы, воспользуйтесь следующим корневым URL-адресом службы:

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

Записные книжки на сайте SharePoint. Чтобы получить доступ к записным книжкам на сайте группы SharePoint, воспользуйтесь следующим корневым URL-адресом службы:

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

Авторизация

Сведения о разрешениях, необходимых для работы с API OneNote, см. в разделе Разрешения для заметок.

Отношения

Связь	Тип	Описание
notebooks	Коллекция notebook	Коллекция записных книжек OneNote, принадлежащих пользователю или группе. Только для чтения. Допускается значение null.
operations	Коллекция onenoteOperation	Состояние операций OneNote. Получение коллекции операций не поддерживается, но вы можете получить состояние длительных операций, если Operation-Location в ответе возвращается заголовок. Только для чтения. Допускается значение null.
pages	Коллекция onenotePage	Страницы всех записных книжек OneNote, принадлежащих пользователю или группе. Только для чтения. Допускается значение null.
resources	Коллекция onenoteResource	Изображения и другие файловые ресурсы на страницах OneNote. Получение коллекции ресурсов не поддерживается, но вы можете получить двоичное содержимое определенного ресурса. Только для чтения. Допускается значение null.
sectionGroups	Коллекция sectionGroup	Группы разделов во всех записных книжках OneNote, принадлежащих пользователю или группе. Только для чтения. Допускает значение null.
sections	Коллекция onenoteSection	Разделы во всех записных книжках OneNote, принадлежащих пользователю или группе. Только для чтения. Допускается значение null.

Методы

Метод	Возвращаемый тип	Описание
Создание записной книжки	notebook	Создание записной книжки путем публикации в коллекции записных книжек.
Список записных книжек	Коллекция объектов notebook	Получение коллекции записных книжек.
Создание страницы	onenotePage	Создание страницы путем публикации в коллекции страниц.
Перечисление страниц	Коллекция onenotePage	Получение коллекции страниц.
Перечисление групп разделов	Коллекция sectionGroup	Получение коллекции групп разделов.
Перечисление разделов	Коллекция onenoteSection	Получение коллекции разделов.

{
  "notebooks": [{ "@odata.type": "microsoft.graph.notebook" }],
  "operations": [{ "@odata.type": "microsoft.graph.onenoteOperation" }],
  "pages": [{ "@odata.type": "microsoft.graph.onenotePage" }],
  "resources": [ { "@odata.type": "microsoft.graph.onenoteResource" } ],
  "sectionGroups": [ { "@odata.type": "microsoft.graph.sectionGroup" } ],
  "sections": [ { "@odata.type": "microsoft.graph.onenoteSection" } ]
}