Поделиться через

Тип ресурса 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, см. в разделе Разрешения для заметок.

Методы

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

Свойства

Нет

Связи

Связь Тип Описание
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. 
{
  "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" } ]
}