Понятие (независимый издатель)

Соединитель идеи использует API для доступа к страницам, базам данных и пользователям Понятия.

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

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Чандра Сехар и Харчини Варма
URL	https://github.com/sekharmalla
Адрес электронной почты	chandra.malla@msftcommunity.com

Метаданные соединителя
Publisher	Чандра Сехар и Харчини Варма
Веб-сайт	https://www.notion.so/
Политика конфиденциальности	https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
Категории	Продуктивность; сотрудничество

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Ключ API	securestring	Ключ API для этого API	True

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

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

Действия

Добавление дочерних блоков	Создает и добавляет новые дочерние блоки к указанному родительскому block_id.
Запрос базы данных	Возвращает список страниц, содержащихся в базе данных, отфильтрованные и упорядоченные в соответствии с условиями фильтра и критериями сортировки, предоставленными в запросе.
Искать	Выполняет поиск по всем страницам и дочерним страницам, которым предоставлен общий доступ к интеграции. Результаты могут включать базы данных.
Обновление блока	Обновляет содержимое для указанного block_id на основе типа блока. Поддерживаемые поля на основе типа блочного объекта
Получение базы данных	Извлекает объект Базы данных с помощью указанного идентификатора.
Получение блока	Извлекает объект Block с помощью указанного идентификатора.
Получение дочерних элементов блока	Возвращает массив дочерних блоков с разбивкой на страницы, содержащийся в блоке с помощью указанного идентификатора.
Получение комментариев	Извлекает список неразрешенных объектов Comment из страницы или блока.
Получение пользователя	Извлекает пользователя с помощью указанного идентификатора.
Получение пользователя бота токена	Извлекает пользователя бота, связанного с маркером API, предоставленным в заголовке авторизации. Бот будет иметь поле владельца с информацией о человеке, который авторизовать интеграцию.
Получение страницы	Извлекает объект Page с помощью указанного идентификатора.
Получение элемента свойства страницы	Получение элемента свойства страницы
Создание примечания	Создает комментарий на странице или существующем потоке обсуждения.
Создание страницы	Создает новую страницу в указанной базе данных. существующая страница.
Список всех пользователей	Возвращает список пользователей с разбивкой на страницы для рабочей области
Удаление блока	Задает объект Block, включая блоки страниц, архивированный: true с помощью указанного идентификатора. Примечание. В приложении пользовательского интерфейса "Понятие" блок перемещается в корзину, где он по-прежнему может быть доступ к нему и восстановлен.

Добавление дочерних блоков

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

Создает и добавляет новые дочерние блоки к указанному родительскому block_id.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор блока	block_id	True	string	Идентификатор блока
объект	object		string	объект
type	type		string	type
type	type		string	type
содержимое	content		string	содержимое
type	type		string	type
содержимое	content		string	содержимое
URL-адрес	url		string	URL-адрес

Запрос базы данных

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

Возвращает список страниц, содержащихся в базе данных, отфильтрованные и упорядоченные в соответствии с условиями фильтра и критериями сортировки, предоставленными в запросе.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор базы данных	database_id	True	string	Идентификатор базы данных "Понятие".

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

Тело: DatabaseResponse

Искать

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

Выполняет поиск по всем страницам и дочерним страницам, которым предоставлен общий доступ к интеграции. Результаты могут включать базы данных.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Query	query	True	string	При указании ограничения, возвращаемые страницами, сравнивая запрос с заголовком страницы.
Направление	direction		string	Направление сортировки. Возможные значения включают возрастание и убывание.
Отметка времени	timestamp		string	Имя метки времени для сортировки. Возможные значения включают last_edited_time.

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

Имя	Путь	Тип	Описание
id	id	string	Идентификатор блока.
Время создания	created_time	string	Дата и время создания этой страницы.
Время последнего изменения	last_edited_time	string	Дата и время обновления этой страницы.
с обычным текстом;	plain_text	string	Обычный текст без заметок.
Метки	Tags	object	Объект тегов содержит список тегов.
URL	url	string	URL-адрес объекта.
Следующий курсор	next_cursor	string	Курсор, возвращаемый для запроса следующей страницы результатов. Рассматривать это как непрозрачное значение
Есть больше	has_more	boolean	Имеет ли блок больше блоков или нет

Обновление блока

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

Обновляет содержимое для указанного block_id на основе типа блока. Поддерживаемые поля на основе типа блочного объекта

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор блока	blockId	True	string	Идентификатор блока "Понятие"
Content	content		string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Цвет	color		string	Цвет блока.
Content	content		string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Цвет	color		string	Цвет блока.
Content	content		string	Текстовое содержимое2. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Цвет	color		string	Цвет блока.
Content	content		string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Цвет	color		string	знамя
Содержимое1	content		string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Цвет	color		string	Цвет блока.
Содержимое1	content		string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Цвет	color		string	Цвет блока.
Содержимое1	content		string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.
Проверено	checked		boolean	Проверяется ли to_do.
Цвет	color		string	Цвет блока.

Получение базы данных

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

Извлекает объект Базы данных с помощью указанного идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор базы данных	database_id	True	string	Идентификатор базы данных "Понятие"

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

Тело: DatabaseResponse

Получение блока

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

Извлекает объект Block с помощью указанного идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор блока	blockId	True	string	Идентификатор блока.

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

Имя	Путь	Тип	Описание
объект	object	string	объект
id	id	string	Идентификатор блока.
Время создания	created_time	date-time	Дата и время создания этого блока.
Время последнего изменения	last_edited_time	date-time	Дата и время последнего обновления этого блока.
Object	created_by.object	string	Всегда "пользователь"
Идентификатор	created_by.id	string	Уникальный идентификатор для этого пользователя.
Object	last_edited_by.object	string	Последний измененный пользователь
Идентификатор	last_edited_by.id	string	Уникальный идентификатор для этого пользователя.
Имеет детей	has_children	boolean	Есть ли в блоке дочерние блоки, вложенные в него.
Archived	archived	boolean	Архивированное состояние блока.
Тип	type	string	Объект, содержащий сведения о блоке для конкретного типа

Получение дочерних элементов блока

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

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор блока	block_id	True	string	Идентификатор блока
Размер страницы	page_size		integer	Количество элементов из полного списка, требуемого в ответе. Максимум: 100

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

Имя	Путь	Тип	Описание
id	items.id	string	Идентификатор блока.
Время создания	items.created_time	date-time	Дата и время создания этого блока.
Время последнего изменения	items.last_edited_time	date-time	Дата и время последнего обновления этого блока.
Имеет детей	items.has_children	boolean	Есть ли в блоке дочерние блоки, вложенные в него.
Archived	items.archived	boolean	Архивированное состояние блока.
Тип	items.type	string	Тип блока. Возможные значения
с обычным текстом;	plain_text	string	Обычный текст в блоке абзаца plain_text
Следующий курсор	next_cursor	string	Курсор, возвращаемый для запроса следующей страницы результатов. Рассматривать это как непрозрачное значение
Есть больше	has_more	boolean	Имеет ли блок больше блоков или нет

Получение комментариев

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

Извлекает список неразрешенных объектов Comment из страницы или блока.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор блока	block_id	True	string	Идентификатор блока понятия или страницы

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

Тело: CommentResponse

Получение пользователя

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

Извлекает пользователя с помощью указанного идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор пользователя	user_id	True	string	Уникальный идентификатор для этого пользователя.

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

Имя	Путь	Тип	Описание
Идентификатор	id	string	Идентификатор пользователя "Понятие"
Имя пользователя	name	string	Имя пользователя
URL-адрес аватара	avatar_url	string	Выбранное изображение аватара
Адрес электронной почты	email	string	Адрес электронной почты пользователя.

Получение пользователя бота токена

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

Извлекает пользователя бота, связанного с маркером API, предоставленным в заголовке авторизации. Бот будет иметь поле владельца с информацией о человеке, который авторизовать интеграцию.

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

Имя	Путь	Тип	Описание
Идентификатор	id	string	Уникальный идентификатор для этого пользователя.
Имя	name	string	Имя пользователя, отображаемое в представлении.
URL-адрес аватара	avatar_url	string	Выбранное изображение аватара.
Тип	type	string	Тип пользователя. Возможные значения: "person" и "bot".
Тип владельца	bot.owner.type	string	Тип владельца — "рабочая область" или "пользователь".

Получение страницы

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

Извлекает объект Page с помощью указанного идентификатора.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор страницы	page_id	True	string	Идентификатор страницы "Понятие"

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

Имя	Путь	Тип	Описание
Идентификатор	id	string	Уникальный идентификатор страницы.
Время создания	created_time	string	Дата и время создания этой страницы. Форматируется как строка времени даты ISO 8601.
Время последнего изменения	last_edited_time	string	Дата и время обновления этой страницы. Форматируется как строка времени даты ISO 8601.
Идентификатор	created_by.id	string	Уникальный идентификатор для этого пользователя.
Идентификатор	last_edited_by.id	string	Уникальный идентификатор для этого пользователя.
URL-адрес	cover.url	string	Ссылка на внешний размещенный образ.
эмодзи	icon.emoji	string	Символ эмодзи.
идентификатор_базы_данных	parent.database_id	string	идентификатор_базы_данных
Архив	archived	boolean	Архивированное состояние страницы.
URL	url	string	URL-адрес страницы "Понятие".

Получение элемента свойства страницы

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

Получение элемента свойства страницы

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор страницы	page_id	True	string	Идентификатор страницы "Понятие"
Идентификатор свойства	property_id	True	string	Идентификатор свойства страницы

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

Имя	Путь	Тип	Описание
Object	object	string	Всегда список.
Есть больше	has_more	boolean	Если ответ включает конец списка, значение false. В противном случае — значение true.

Создание примечания

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

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

Параметры

Имя	Ключ	Тип	Описание
Идентификатор страницы	page_id	string	Идентификатор страницы
Идентификатор обсуждения	discussion_id	string	Идентификатор блока "Понятие"
Content	content	string	Текстовое содержимое. Это поле содержит фактическое содержимое текста и, вероятно, поле, используемое чаще всего.

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

Тело: CommentResponse

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

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

Создает новую страницу в указанной базе данных. существующая страница.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор базы данных	database_id	True	string	Уникальный идентификатор базы данных.
Эмодзи	emoji		string	эмодзи
URL-адрес обложки	url		string	URL-адрес изображения обложки страницы.
Свойства	properties		object	Схема свойств базы данных, как они отображаются в представлении.

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

Имя	Путь	Тип	Описание
Идентификатор	id	string	Уникальный идентификатор страницы.
Время создания	created_time	string	Дата и время создания этой страницы. Форматируется как строка времени даты ISO 8601.
Время последнего изменения	last_edited_time	string	Дата и время обновления этой страницы. Форматируется как строка времени даты ISO 8601.
Идентификатор	created_by.id	string	Уникальный идентификатор для этого пользователя.
Идентификатор	last_edited_by.id	string	Уникальный идентификатор для этого пользователя.
URL-адрес	cover.url	string	Ссылка на внешний размещенный образ.
эмодзи	icon.emoji	string	Символ эмодзи.
идентификатор_базы_данных	parent.database_id	string	идентификатор_базы_данных
Архив	archived	boolean	Архивированное состояние страницы.
URL	url	string	URL-адрес страницы "Понятие".

Список всех пользователей

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

Возвращает список пользователей с разбивкой на страницы для рабочей области

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Размер страницы	page_size		integer	Количество элементов из полного списка, требуемого в ответе. Максимум: 100

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

Имя	Путь	Тип	Описание
Идентификатор	id	string	Идентификатор блока "Понятие"
Отображаемое имя	name	string	Имя пользователя, отображаемое в представлении.
URL-адрес аватара	avatar_url	string	Выбранное изображение аватара.
Тип	type	string	Тип пользователя. Возможные значения: "person" и "bot".
Адрес электронной почты	email	string	Адрес электронной почты пользователя.
Следующий курсор	next_cursor	string	Курсор, возвращаемый для запроса следующей страницы результатов. Рассматривать это как непрозрачное значение
Есть больше	has_more	boolean	Если ответ включает конец списка

Удаление блока

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

Задает объект Block, включая блоки страниц, архивированный: true с помощью указанного идентификатора. Примечание. В приложении пользовательского интерфейса "Понятие" блок перемещается в корзину, где он по-прежнему может быть доступ к нему и восстановлен.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор блока	blockId	True	string	Идентификатор блока "Понятие"

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

Имя	Путь	Тип	Описание
id	id	string	Идентификатор блока.
Время создания	created_time	date-time	Дата и время создания этого блока.
Время последнего изменения	last_edited_time	date-time	Дата и время последнего обновления этого блока.
Object	created_by.object	string	Всегда "пользователь"
Идентификатор	created_by.id	string	Уникальный идентификатор для этого пользователя.
Object	last_edited_by.object	string	Последний измененный пользователь
Идентификатор	last_edited_by.id	string	Уникальный идентификатор для этого пользователя.
Имеет детей	has_children	boolean	Есть ли в блоке дочерние блоки, вложенные в него.
Archived	archived	boolean	Архивированное состояние блока.
Тип	type	string	Объект, содержащий сведения о блоке для конкретного типа

Определения

CommentResponse

Имя	Путь	Тип	Описание
Идентификатор	id	string	Уникальный идентификатор комментария.
Идентификатор страницы	parent.page_id	string	Идентификатор страницы, к которой принадлежит эта страница.
Идентификатор обсуждения	discussion_id	string	Уникальный идентификатор потока обсуждения, с которым связан комментарий.
Время создания	created_time	string	Дата и время создания этого комментария.
Время последнего изменения	last_edited_time	string	Дата и время обновления этого комментария.
объект	created_by.object	string	объект
id	created_by.id	string	id
Форматированный текст	rich_text	array of object	Содержимое комментария, которое поддерживает форматирование форматированного текста, ссылки и упоминания.
type	rich_text.type	string	type
Content	rich_text.text.content	string	Текстовое содержимое.
Link	rich_text.text.link	string	Любая встроенная ссылка в этом тексте.
с обычным текстом;	rich_text.plain_text	string	Обычный текст без заметок.
href	rich_text.href	string	(необязательно) URL-адрес любой ссылки или внутреннего понятия в этом тексте, если таковой есть.

DatabaseResponse

Имя	Путь	Тип	Описание
results	results	array of object
Object	results.object	string	Страница или база данных
Идентификатор	results.id	string	Уникальный идентификатор базы данных.
Время создания	results.created_time	string	Дата и время создания этой базы данных. Форматируется как строка времени даты ISO 8601.
Время последнего изменения	results.last_edited_time	string	Дата и время обновления этой базы данных. Форматируется как строка времени даты ISO 8601.
Object	results.created_by.object	string	Пользователь, создавший базу данных.
Идентификатор	results.created_by.id	string	Уникальный идентификатор пользователя
Object	results.last_edited_by.object	string	Пользователь, создавший базу данных.
Идентификатор	results.last_edited_by.id	string	Уникальный идентификатор пользователя
Archived	results.archived	boolean	Архивированное состояние базы данных.
URL	results.url	string	URL-адрес базы данных "Понятие"