Тип ресурса onenote

  • Статья

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

Представляет точку входа для ресурсов 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 Получение коллекции записных книжек.
Создание страницы Страницы Создание страницы путем публикации в коллекции страниц.
Перечисление страниц коллекция страниц Получение коллекции страниц.
Перечисление групп разделов Коллекция 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.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "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" } ]
}