Notion
Управление страницами Notion
Интеграция инструмента Notion позволяет вашим агентам читать, создавать и управлять страницами и базами данных Notion непосредственно в ваших рабочих процессах. Это позволяет автоматизировать извлечение и обновление структурированного контента, заметок, документов и другого содержимого из вашего рабочего пространства Notion.
С помощью инструмента Notion вы можете:
- Читать страницы или базы данных: Извлекать богатый контент или метаданные из указанных страниц Notion или целых баз данных
- Создавать новый контент: Программно создавать новые страницы или базы данных для динамической генерации контента
- Добавлять контент: Добавлять новые блоки или свойства к существующим страницам и базам данных
- Запрашивать базы данных: Выполнять расширенные фильтры и поиск по структурированным данным Notion для пользовательских рабочих процессов
- Искать в рабочем пространстве: Автоматически находить страницы и базы данных во всем вашем рабочем пространстве Notion
Этот инструмент идеально подходит для сценариев, где агентам необходимо синхронизировать информацию, генерировать отчеты или поддерживать структурированные заметки в Notion. Включая возможности Notion в автоматизированные рабочие процессы, вы позволяете вашим агентам программно и бесшовно взаимодействовать со знаниями, документацией и данными управления проектами.
Интегрируйте Notion в рабочий процесс. Может читать страницы, читать базы данных, создавать страницы, создавать базы данных, добавлять контент, запрашивать базы данных и искать в рабочем пространстве.
Чтение контента со страницы Notion
| Параметр | Тип | Обязательный | Описание |
|---|
pageId | string | Да | UUID страницы Notion для чтения |
| Параметр | Тип | Описание |
|---|
url | string | URL страницы Notion |
created_time | string | Временная метка создания в формате ISO 8601 |
last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
content | string | Контент страницы в формате markdown |
title | string | Заголовок страницы |
Чтение информации и структуры базы данных из Notion
| Параметр | Тип | Обязательный | Описание |
|---|
databaseId | string | Да | UUID базы данных Notion для чтения |
| Параметр | Тип | Описание |
|---|
id | string | UUID базы данных |
url | string | URL базы данных Notion |
created_time | string | Временная метка создания в формате ISO 8601 |
last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
properties | object | Схема свойств базы данных |
title | string | Заголовок базы данных |
Добавление контента на страницу Notion
| Параметр | Тип | Обязательный | Описание |
|---|
pageId | string | Да | UUID страницы Notion для добавления контента |
content | string | Да | Контент для добавления на страницу |
| Параметр | Тип | Описание |
|---|
appended | boolean | Успешно ли добавлен контент |
Создание новой страницы в Notion
| Параметр | Тип | Обязательный | Описание |
|---|
parentId | string | Да | UUID родительской страницы Notion, где будет создана эта страница |
title | string | Нет | Заголовок новой страницы |
content | string | Нет | Опциональный контент для добавления на страницу при создании |
| Параметр | Тип | Описание |
|---|
id | string | UUID страницы |
url | string | URL страницы Notion |
created_time | string | Временная метка создания в формате ISO 8601 |
last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
title | string | Заголовок страницы |
Обновление свойств страницы Notion
| Параметр | Тип | Обязательный | Описание |
|---|
pageId | string | Да | UUID страницы Notion для обновления |
properties | json | Да | JSON-объект свойств для обновления |
| Параметр | Тип | Описание |
|---|
id | string | UUID страницы |
url | string | URL страницы Notion |
last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
title | string | Заголовок страницы |
Запрос и фильтрация записей базы данных Notion с расширенной фильтрацией
| Параметр | Тип | Обязательный | Описание |
|---|
databaseId | string | Да | UUID базы данных Notion для запроса |
filter | string | Нет | Условия фильтрации в формате JSON (опционально) |
sorts | string | Нет | Критерии сортировки в формате JSON-массива (опционально) |
pageSize | number | Нет | Количество результатов для возврата (по умолчанию: 100, максимум: 100) |
| Параметр | Тип | Описание |
|---|
results | array | Массив объектов страниц из базы данных |
↳ object | string | Всегда "page" |
↳ id | string | UUID страницы |
↳ created_time | string | Временная метка создания в формате ISO 8601 |
↳ last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
↳ created_by | object | Частичный объект пользователя |
↳ object | string | Всегда "user" |
↳ id | string | UUID пользователя |
↳ last_edited_by | object | Частичный объект пользователя |
↳ object | string | Всегда "user" |
↳ id | string | UUID пользователя |
↳ archived | boolean | Архивирована ли страница |
↳ in_trash | boolean | Находится ли страница в корзине |
↳ url | string | URL страницы Notion |
↳ public_url | string | Публичный веб-URL, если доступен, иначе null |
↳ parent | object | Родительский объект, определяющий иерархические отношения |
↳ type | string | Тип родителя: "database_id", "data_source_id", "page_id", "workspace" или "block_id" |
↳ database_id | string | UUID родительской базы данных (если тип database_id) |
↳ data_source_id | string | UUID родительского источника данных (если тип data_source_id) |
↳ page_id | string | UUID родительской страницы (если тип page_id) |
↳ workspace | boolean | True, если родитель — рабочее пространство (если тип workspace) |
↳ block_id | string | UUID родительского блока (если тип block_id) |
↳ icon | object | Иконка страницы/базы данных (эмодзи, custom_emoji или файл) |
↳ url | string | Аутентифицированный URL, действительный в течение одного часа |
↳ expiry_time | string | Временная метка истечения срока действия URL в формате ISO 8601 |
↳ cover | object | Обложка страницы/базы данных |
↳ type | string | Тип файла: "file", "file_upload" или "external" |
↳ file | object | Объект файла, размещенного в Notion (когда тип "file") |
↳ url | string | Аутентифицированный URL, действительный в течение одного часа |
↳ expiry_time | string | Временная метка истечения срока действия URL в формате ISO 8601 |
↳ file_upload | object | Объект файла, загруженного через API (когда тип "file_upload") |
↳ id | string | UUID загруженного файла |
↳ external | object | Объект внешнего файла (когда тип "external") |
↳ url | string | URL внешнего файла (никогда не истекает) |
↳ properties | object | Значения свойств страницы (структура зависит от типа родителя — свойства базы данных или только заголовок) |
has_more | boolean | Доступны ли дополнительные результаты |
next_cursor | string | Курсор для следующей страницы результатов |
total_results | number | Количество возвращенных результатов |
Поиск по всем страницам и базам данных в рабочем пространстве Notion
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Нет | Поисковые термины для поиска страниц и баз данных (оставьте пустым, чтобы получить все страницы) |
filterType | string | Нет | Фильтр по типу объекта: "page", "database" или оставьте пустым для всех |
pageSize | number | Нет | Количество результатов для возврата (по умолчанию: 100, максимум: 100) |
| Параметр | Тип | Описание |
|---|
results | array | Массив результатов поиска (страниц и/или баз данных) |
↳ object | string | Тип объекта: "page" или "database" |
↳ id | string | UUID объекта |
↳ created_time | string | Временная метка создания в формате ISO 8601 |
↳ last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
↳ created_by | object | Частичный объект пользователя |
↳ object | string | Всегда "user" |
↳ id | string | UUID пользователя |
↳ last_edited_by | object | Частичный объект пользователя |
↳ object | string | Всегда "user" |
↳ id | string | UUID пользователя |
↳ archived | boolean | Архивирован ли объект |
↳ in_trash | boolean | Находится ли объект в корзине |
↳ url | string | URL объекта |
↳ public_url | string | Публичный веб-URL, если доступен |
↳ parent | object | Родительский объект, определяющий иерархические отношения |
↳ type | string | Тип родителя: "database_id", "data_source_id", "page_id", "workspace" или "block_id" |
↳ database_id | string | UUID родительской базы данных (если тип database_id) |
↳ data_source_id | string | UUID родительского источника данных (если тип data_source_id) |
↳ page_id | string | UUID родительской страницы (если тип page_id) |
↳ workspace | boolean | True, если родитель — рабочее пространство (если тип workspace) |
↳ block_id | string | UUID родительского блока (если тип block_id) |
↳ properties | object | Свойства объекта |
has_more | boolean | Доступны ли дополнительные результаты |
next_cursor | string | Курсор для следующей страницы результатов |
total_results | number | Количество возвращенных результатов |
Создание новой базы данных в Notion с пользовательскими свойствами
| Параметр | Тип | Обязательный | Описание |
|---|
parentId | string | Да | ID родительской страницы, где будет создана база данных |
title | string | Да | Заголовок для новой базы данных |
properties | json | Нет | Свойства базы данных в формате JSON-объекта (опционально, создаст свойство "Name" по умолчанию, если пусто) |
| Параметр | Тип | Описание |
|---|
id | string | UUID базы данных |
url | string | URL базы данных Notion |
created_time | string | Временная метка создания в формате ISO 8601 |
properties | object | Схема свойств базы данных |
title | string | Заголовок базы данных |
Добавление новой строки в базу данных Notion с указанными свойствами
| Параметр | Тип | Обязательный | Описание |
|---|
databaseId | string | Да | ID базы данных для добавления строки |
properties | json | Да | Свойства строки в формате JSON-объекта, соответствующего схеме базы данных (например, {"Name": {"title": [{"text": {"content": "Task 1"}}]}, "Status": {"select": {"name": "Done"}}}) |
| Параметр | Тип | Описание |
|---|
id | string | UUID страницы |
url | string | URL страницы Notion |
created_time | string | Временная метка создания в формате ISO 8601 |
last_edited_time | string | Временная метка последнего редактирования в формате ISO 8601 |
title | string | Заголовок строки |
