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

OneNote (бизнес)

OneNote — это заметка, которая позволяет легко синхронизировать идеи, эскизы и заметки на всех устройствах. Подключитесь к учетной записи Office 365 с поддержкой OneDrive для бизнеса, чтобы отслеживать новые разделы, создавать заметки и многое другое.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate
Логические приложения Стандарт Все регионы Logic Apps
Power Apps Стандарт Все регионы Power Apps
Power Automate Стандарт Все регионы Power Automate
Метаданные соединителя
Publisher Microsoft
Website https://products.office.com/onenote/digital-note-taking-app

Чтобы использовать эту интеграцию, вам потребуется доступ к записной книжке OneNote, хранящейся в OneDrive для бизнеса. Чтобы сделать подключение, нажмите кнопку "Войти". Вам будет предложено предоставить учетную запись O365 с поддержкой OneDrive для бизнеса, следуйте остальным экранам, чтобы создать подключение.

Известные проблемы и ограничения

  1. При использовании подключения, если вы не видите список записных книжек, которые вы ожидаете, проверьте учетную запись, с помощью которую вы создали подключение и повторите попытку. Если при использовании соединителя возникает ошибка, вы можете найти код ошибки для получения дополнительных сведений.
  2. Для этой интеграции требуется подключение с учетной записью с разрешением UserRemoteAPIs. Если вы увидите эту ошибку: "Ошибка: у пользователя нет разрешений на доступ к запрошенным ресурсам", у учетной записи может не быть правильных разрешений. Администратор SharePoint может управлять уровнями разрешений, просматривая семейство веб-сайтов и открыв параметры сайта. Выберите разрешения сайта, а затем уровень разрешений, чтобы просмотреть разрешения (например, использование удаленных интерфейсов) на уровне. Если пользователь, принадлежащий определенному уровню, не имеет требуемого разрешения, измените уровень, установите флажок для разрешения или создайте новый уровень разрешений и назначьте его пользователю.
  3. Соединитель в настоящее время не поддерживает явное название страницы входных параметров для действий создания страницы . Это ограничение, возникающее из реализации API OneNote. Однако заголовок можно указать как часть содержимого страницы в HTML с помощью <тегов заголовка>< изаголовка>.
  4. Раздел записной книжки. Если вы хотите указать настраиваемое значение для параметра "Раздел записной книжки", укажите его в формате URL-адреса API. Шаблон URL-адреса API: https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages. Дополнительные сведения см. в документации по API OneNote.
  5. Создание страницы в действии "Быстрые заметки" не поддерживается в следующих регионах:
    • Logic Apps:
      • Azure Government
      • регионы Azure для Китая.
    • Power Automate и Power Apps:
      • Правительство США (GCC)
      • Правительство США (GCC High)
      • China Cloud, управляемый 21Vianet
  6. Действие "Получение содержимого страницы" не поддерживается в Power Apps, однако это действие поддерживается в Power Automate.

Замечание

В имени записной книжки недопустимы следующие символы: *":<>?/|%

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд
Частота опросов триггеров 1 1200 секунд

Действия

Обновление содержимого страницы

Обновление содержимого HTML-страницы.
Получение последних записных книжек

Получение последних записных книжек.
Получение разделов в записной книжке

Получение разделов в определенной записной книжке.
Получение содержимого страницы

Получение содержимого HTML-страницы.
Получение страниц для определенного раздела

Получение страниц для определенного раздела.
Создание раздела в записной книжке

Создание раздела в записной книжке.
Создание страницы в кратких заметках

Создайте новую страницу в разделе "Краткие заметки".
Создание страницы в разделе

Создайте новую страницу в указанном разделе.
Удаление страницы

Удаление страницы.

Обновление содержимого страницы

Идентификатор операции:
UpdatePageContent

Обновление содержимого HTML-страницы.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Раздел записной книжки
 sectionId True string

URL-адрес API страниц раздела.
Идентификатор страницы
 pageId True string

Уникальный идентификатор страницы.
Цель
 target string

Элемент для обновления.
Действие
 action string

Действие для выполнения в целевом элементе.
Местоположение
 position string

Расположение для добавления предоставленного содержимого.
Content
 content html

Новое содержимое.

Возвращаемое значение

Содержимое HTML страницы

response
string

Получение последних записных книжек

Идентификатор операции:
GetNotebooks

Получение последних записных книжек.

Возвращаемое значение

response
array of Notebook

Получение разделов в записной книжке

Идентификатор операции:
GetSectionsInNotebook

Получение разделов в определенной записной книжке.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.

Возвращаемое значение

Имя Путь Тип Описание
value
 value array of SectionListItem

Получение содержимого страницы

Идентификатор операции:
GetPageContent

Получение содержимого HTML-страницы.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Раздел записной книжки
 sectionId True string

URL-адрес API страниц раздела.
Идентификатор страницы
 pageId True string

Уникальный идентификатор страницы.

Возвращаемое значение

Содержимое HTML страницы

response
string

Получение страниц для определенного раздела

Идентификатор операции:
GetPagesInSection

Получение страниц для определенного раздела.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Раздел записной книжки
 sectionId True string

URL-адрес API страниц раздела.

Возвращаемое значение

Тело
GetPagesInSectionResponse

Создание раздела в записной книжке

Идентификатор операции:
CreateSectionInNotebook

Создание раздела в записной книжке.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Имя нового раздела
 name string

Имя нового раздела.

Возвращаемое значение

Тело
CreateSectionInNotebookResponse

Создание страницы в кратких заметках

Идентификатор операции:
CreatePageInQuickNotes

Создайте новую страницу в разделе "Краткие заметки".

Параметры

Имя Ключ Обязательно Тип Описание
Содержимое страницы
 pageContent True html

Содержимое страницы.

Возвращаемое значение

Тело
Page

Создание страницы в разделе

Идентификатор операции:
CreatePageInSection

Создайте новую страницу в указанном разделе.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Раздел записной книжки
 sectionId True string

URL-адрес API страниц раздела.
Содержимое страницы
 pageContent True html

Содержимое страницы.

Возвращаемое значение

Тело
Page

Удаление страницы

Идентификатор операции:
DeletePage

Удаление страницы.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Раздел записной книжки
 sectionId True string

URL-адрес API страниц раздела.
Идентификатор страницы
 pageId True string

Уникальный идентификатор страницы.

Триггеры

При создании нового раздела

Активирует поток при добавлении нового раздела в записную книжку.
При создании новой группы разделов

Активирует поток при добавлении новой группы разделов в записную книжку.
При создании новой страницы в разделе

Активирует поток при добавлении новой страницы в раздел.

При создании нового раздела

Идентификатор операции:
OnNewSectionInNotebook

Активирует поток при добавлении нового раздела в записную книжку.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.

Возвращаемое значение

Ответ на новый раздел.

Тело
NewSectionResponse

При создании новой группы разделов

Идентификатор операции:
OnNewSectionGroupInNotebook

Активирует поток при добавлении новой группы разделов в записную книжку.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.

Возвращаемое значение

Ответ для новой группы разделов.

Тело
NewSectionGroupResponse

При создании новой страницы в разделе

Идентификатор операции:
OnNewPageInSection

Активирует поток при добавлении новой страницы в раздел.

Параметры

Имя Ключ Обязательно Тип Описание
Ключ записной книжки
 notebookKey True string

Ключ, определяющий записную книжку. Обратите внимание, что это зависит от API и не может быть типизированным.
Раздел записной книжки
 sectionId True string

URL-адрес API страниц раздела.

Возвращаемое значение

Ответ на новую страницу.

Тело
NewPageResponse

Определения

CreateSectionInNotebookResponse

Имя Путь Тип Описание
Контекст OData
 @odata.context string

Контекст OData.
Создано по имени
 createdBy string

Этот раздел создан по имени.
Время создания
 createdTime date-time

Этот раздел создал время.
Создание раздела в идентификаторе объекта записной книжки
 id string
Флаг раздела по умолчанию
 isDefault boolean

Флаг, указывающий, является ли это разделом по умолчанию.
Последнее изменение
 lastModifiedBy string

Последнее изменение по имени.
время последнего изменения;
 lastModifiedTime date-time

Время последнего изменения этого раздела.
Href клиента для настольных компьютеров
 links.oneNoteClientUrl.href string

Href для классического клиента OneNote.
Веб-клиент href
 links.oneNoteWebUrl.href string

Href веб-клиента OneNote.
Имя раздела
 name string

Имя раздела.
URL-адрес страниц
 pagesUrl string

URL-адрес страниц.
Url-адрес для создания раздела в записной книжке
 self string

URL-адрес для создания раздела в группе записных книжек.

Страница

Имя Путь Тип Описание
Заголовок страницы
 title string

Заголовок страницы.
links
 links Link

Ссылки, связанные со страницей OneNote.
URL-адрес содержимого
 contentUrl string

URL-адрес содержимого страницы.
"Дата последнего изменения";
 lastModifiedTime date-time

Дата последнего изменения страницы.
Дата создания
 createdTime date-time

Дата создания страницы.
Идентификатор
 id string

Уникальный идентификатор страницы.

Notebook

Имя Путь Тип Описание
Имя файла
 FileName string
Key
 Key string

ParentNotebook

Имя Путь Тип Описание
Ключ родительской записной книжки
 id string

Уникальный идентификатор родительской записной книжки.
Имя родительской записной книжки
 name string

Имя родительской записной книжки.
URL-адрес родительской записной книжки
 self string

Ссылка url-адреса на родительскую записную книжку.

Ссылки, связанные со страницей OneNote.

Имя Путь Тип Описание
oneNoteClientUrl
 oneNoteClientUrl OneNoteClientUrl
oneNoteWebUrl
 oneNoteWebUrl OneNoteWebUrl

OneNoteClientUrl

Имя Путь Тип Описание
URL-адрес клиента OneNote
 href string

Ссылка на записную книжку с помощью клиента Windows OneNote.

OneNoteWebUrl

Имя Путь Тип Описание
URL-адрес OneNote
 href string

Ссылка на записную книжку с помощью веб-клиента OneNote.

SectionListItem

Поля, включенные в элемент списка разделов.

Имя Путь Тип Описание
Имя раздела
 name string

Имя раздела.
Ключ раздела
 pagesUrl string

Ключ, используемый для ссылки на этот раздел; также URL-адрес страниц.
Идентификатор раздела
 id string

Уникальный идентификатор раздела.

SectionResponse

Поля, включенные в раздел.

Имя Путь Тип Описание
Создатель
 createdBy string

Создатель раздела.
Дата создания
 createdTime date-time

Дата и время создания раздела.
Идентификатор раздела
 id string

Уникальный идентификатор раздела.
Последнее изменение
 lastModifiedBy string

Пользователь, который последний раз изменил раздел.
"Дата последнего изменения";
 lastModifiedTime date-time

Дата и время последнего изменения раздела.
Имя раздела
 name string

Имя раздела.
URL-адрес страниц
 pagesUrl string

Url-адрес страниц в этом разделе.
parentNotebook
 parentNotebook ParentNotebook
URL-адрес
 self string

URL-адрес этого раздела.

SectionGroupResponse

Поля, включенные в группу разделов.

Имя Путь Тип Описание
Дата создания
 createdTime date-time

Дата и время создания группы разделов.
Создатель
 createdBy string

Создатель группы разделов.
Идентификатор
 id string

Уникальный идентификатор группы разделов.
Последний модификатор
 lastModifiedBy string

Пользователь, который последний раз изменил группу разделов.
Дата последнего изменения
 lastModifiedTime date-time

Дата последнего изменения и время группы разделов.
Имя
 name string

Имя группы разделов.
URL-адрес разделов
 sectionsUrl string

URL-адрес разделов в этой группе разделов.
URL-адрес группы разделов
 self string

URL-адрес этой группы разделов.

NewSectionResponse

Ответ на новый раздел.

Имя Путь Тип Описание
Разделы
 value array of SectionResponse

Массив объектов, каждый из которых представляет определенный раздел.

NewSectionGroupResponse

Ответ для новой группы разделов.

Имя Путь Тип Описание
Группы разделов
 value array of SectionGroupResponse

Массив объектов, каждый из которых представляет определенную группу разделов.

NewPageResponse

Ответ на новую страницу.

Имя Путь Тип Описание
Страницы
 value array of Page

Массив объектов, каждый из которых представляет определенную страницу.

GetPagesInSectionResponse

Имя Путь Тип Описание
Контекст OData
 @odata.context string

Контекст OData.
Страницы в объекте значения раздела
 value array of object

value
URL-адрес содержимого
 value.contentUrl string

URL-адрес содержимого.
Создан идентификатором приложения
 value.createdByAppId string

Созданный идентификатором приложения.
Время создания
 value.createdTime date-time

Время создания ответа.
Уникальный идентификатор ответа
 value.id string

Уникальный идентификатор для этого ответа.
Время последнего изменения
 value.lastModifiedTime date-time

Время последнего изменения для этого объекта.
Href для классического клиента OneNote
 value.links.oneNoteClientUrl.href string

Href для классического клиента OneNote.
Href веб-клиента OneNote
 value.links.oneNoteWebUrl.href string

Href веб-клиента OneNote.
Уникальный идентификатор родительского раздела
 value.parentSection.id string

Уникальный идентификатор родительского раздела этого объекта.
Имя родительского раздела
 value.parentSection.name string
Страницы в родительском разделе раздела
 value.parentSection.self string

URL-адрес страниц в родительском разделе раздела.
Контекст OData родительского раздела
 value.parentSection@odata.context string

Контекст OData родительского раздела.
Страница в группе разделов
 value.self string

URL-адрес группы "Страницы в разделе".
Заголовок страницы
 value.title string

Заголовок страницы.

струна

Это базовый тип данных string.