概念（独立出版商）

概念连接器使用 API 访问 Notion 的页面、数据库和用户。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	钱德拉·塞卡哈尔和哈西尼·瓦尔马
URL	https://github.com/sekharmalla
Email	chandra.malla@msftcommunity.com

连接器元数据
发布者	钱德拉·塞卡哈尔和哈西尼·瓦尔马
网站	https://www.notion.so/
隐私策略	https://www.notion.so/Privacy-Policy-3468d120cf614d4c9014c09f6adc9091
类别	生产力;协作

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
API 密钥	securestring	此 API 的 API 密钥	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

创建注释	在页面或现有讨论线程中创建注释。
创建页面	在指定的数据库中创建新页。现有页面。
删除块	使用指定的 ID 将 Block 对象（包括页块）设置为存档：true。注意：在概念 UI 应用程序中，这会将块移动到“回收站”，在那里仍然可以访问和还原它。
所有用户列表	返回工作区的“用户”分页列表
搜寻	搜索与集成共享的所有页面和子页。结果可能包括数据库。
更新块	根据块类型更新指定block_id的内容。基于块对象类型的支持字段
查询数据库	获取数据库中包含的 Pages 列表，根据请求中提供的筛选条件和排序条件进行筛选和排序。
检索令牌的机器人用户	检索与授权标头中提供的 API 令牌关联的机器人用户。机器人将具有所有者字段，其中包含有关授权集成的人员的信息。
检索块	使用指定的 ID 检索 Block 对象。
检索块子级	使用指定的 ID 返回块中包含的子块对象的分页数组
检索数据库	使用指定的 ID 检索数据库对象。
检索注释	从页面或块中检索未解析的 Comment 对象的列表。
检索用户	使用指定的 ID 检索用户。
检索页面	使用指定的 ID 检索 Page 对象。
检索页面属性项	检索页面属性项
追加块子级	创建新子块并将其追加到指定的父级block_id。

创建注释

操作 ID:: Createcomment

在页面或现有讨论线程中创建注释。

参数

名称	密钥	类型	说明
页面 ID	page_id	string	页面的标识符
讨论 ID	discussion_id	string	概念块的标识符
Content	content	string	文本内容。此字段包含文本的实际内容，可能是最常使用的字段。

Body: CommentResponse

创建页面

操作 ID:: CreateaPage

在指定的数据库中创建新页。现有页面。

参数

名称	密钥	必需	类型	说明
数据库 ID	database_id	True	string	数据库的唯一标识符。
表情	emoji		string	表情符号
封面 URL	url		string	页面封面图像 URL。
属性	properties		object	在 Notion 中显示的数据库属性架构。

名称	路径	类型	说明
Id	id	string	页面的唯一标识符。
创建时间	created_time	string	创建此页面的日期和时间。格式为 ISO 8601 日期时间字符串。
上次编辑时间	last_edited_time	string	更新此页面的日期和时间。格式为 ISO 8601 日期时间字符串。
Id	created_by.id	string	此用户的唯一标识符。
Id	last_edited_by.id	string	此用户的唯一标识符。
网址	cover.url	string	链接到外部托管映像。
表情符号	icon.emoji	string	表情符号字符。
database_id	parent.database_id	string	database_id
存档	archived	boolean	页面的存档状态。
URL	url	string	“概念”页的 URL。

删除块

操作 ID:: Deleteablock

使用指定的 ID 将 Block 对象（包括页块）设置为存档：true。注意：在概念 UI 应用程序中，这会将块移动到“回收站”，在那里仍然可以访问和还原它。

参数

名称	密钥	必需	类型	说明
块 ID	blockId	True	string	概念块的标识符

名称	路径	类型	说明
id	id	string	块的标识符。
创建时间	created_time	date-time	创建此块的日期和时间。
上次编辑时间	last_edited_time	date-time	上次更新此块的日期和时间。
物体	created_by.object	string	始终为“user”
Id	created_by.id	string	此用户的唯一标识符。
物体	last_edited_by.object	string	上次编辑的用户
Id	last_edited_by.id	string	此用户的唯一标识符。
有孩子	has_children	boolean	块是否具有嵌套在其中的子块。
已存档	archived	boolean	块的存档状态。
类型	type	string	包含特定于类型的块信息的对象

所有用户列表

操作 ID:: List_of_all_users

返回工作区的“用户”分页列表

参数

名称	密钥	必需	类型	说明
页面大小	page_size		integer	响应中所需的完整列表中的项数。最大值：100

名称	路径	类型	说明
Id	id	string	概念块的标识符
显示名称	name	string	概念中显示的用户名。
虚拟形象 URL	avatar_url	string	选择的头像图像。
类型	type	string	用户的类型。可能的值为“person”和“bot”。
Email	email	string	人员的电子邮件地址。
下一个游标	next_cursor	string	返回的游标用于请求下一页的结果。将此视为不透明值
拥有更多内容	has_more	boolean	响应包含列表末尾时

搜寻

操作 ID:: 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	块是否具有更多块

更新块

操作 ID:: Updateablock

根据块类型更新指定block_id的内容。基于块对象类型的支持字段

参数

名称	密钥	必需	类型	说明
块 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	颜色
Contents1	content		string	文本内容。此字段包含文本的实际内容，可能是最常使用的字段。
颜色	color		string	块的颜色。
Contents1	content		string	文本内容。此字段包含文本的实际内容，可能是最常使用的字段。
颜色	color		string	块的颜色。
Contents1	content		string	文本内容。此字段包含文本的实际内容，可能是最常使用的字段。
已选中	checked		boolean	是否检查to_do。
颜色	color		string	块的颜色。

查询数据库

操作 ID:: Query_a_database

获取数据库中包含的 Pages 列表，根据请求中提供的筛选条件和排序条件进行筛选和排序。

参数

名称	密钥	必需	类型	说明
数据库 ID	database_id	True	string	Notion 数据库的标识符。

Body: DatabaseResponse

检索令牌的机器人用户

操作 ID:: RetrieveYourTokensBotUser

检索与授权标头中提供的 API 令牌关联的机器人用户。机器人将具有所有者字段，其中包含有关授权集成的人员的信息。

名称	路径	类型	说明
Id	id	string	此用户的唯一标识符。
Name	name	string	概念中显示的用户名。
虚拟形象 URL	avatar_url	string	选择的头像图像。
类型	type	string	用户的类型。可能的值为“person”和“bot”。
所有者类型	bot.owner.type	string	所有者类型 -“workspace”或“user”。

检索块

操作 ID:: Retrieveablock

使用指定的 ID 检索 Block 对象。

参数

名称	密钥	必需	类型	说明
块 ID	blockId	True	string	块的标识符。

名称	路径	类型	说明
对象	object	string	对象
id	id	string	块的标识符。
创建时间	created_time	date-time	创建此块的日期和时间。
上次编辑时间	last_edited_time	date-time	上次更新此块的日期和时间。
物体	created_by.object	string	始终为“user”
Id	created_by.id	string	此用户的唯一标识符。
物体	last_edited_by.object	string	上次编辑的用户
Id	last_edited_by.id	string	此用户的唯一标识符。
有孩子	has_children	boolean	块是否具有嵌套在其中的子块。
已存档	archived	boolean	块的存档状态。
类型	type	string	包含特定于类型的块信息的对象

检索块子级

操作 ID:: Retrieve_block_children

使用指定的 ID 返回块中包含的子块对象的分页数组

参数

名称	密钥	必需	类型	说明
块 ID	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	块是否具有嵌套在其中的子块。
已存档	items.archived	boolean	块的存档状态。
类型	items.type	string	块的类型。可能的值
纯文本	plain_text	string	段落块中的纯文本plain_text
下一个游标	next_cursor	string	返回的游标用于请求下一页的结果。将此视为不透明值
拥有更多内容	has_more	boolean	块是否具有更多块

检索数据库

操作 ID:: Retrieve_a_database

使用指定的 ID 检索数据库对象。

参数

名称	密钥	必需	类型	说明
数据库 ID	database_id	True	string	概念数据库的标识符

Body: DatabaseResponse

检索注释

操作 ID:: Retrievecomments

从页面或块中检索未解析的 Comment 对象的列表。

参数

名称	密钥	必需	类型	说明
块 ID	block_id	True	string	概念块或页面的标识符

Body: CommentResponse

检索用户

操作 ID:: Retrieveuser

使用指定的 ID 检索用户。

参数

名称	密钥	必需	类型	说明
用户 ID	user_id	True	string	此用户的唯一标识符。

名称	路径	类型	说明
Id	id	string	概念用户的标识符
用户名	name	string	用户的名称
虚拟形象 URL	avatar_url	string	所选头像图像
Email	email	string	人员的电子邮件地址。

检索页面

操作 ID:: Retrieveapage

使用指定的 ID 检索 Page 对象。

参数

名称	密钥	必需	类型	说明
页面 ID	page_id	True	string	“概念”页的标识符

名称	路径	类型	说明
Id	id	string	页面的唯一标识符。
创建时间	created_time	string	创建此页面的日期和时间。格式为 ISO 8601 日期时间字符串。
上次编辑时间	last_edited_time	string	更新此页面的日期和时间。格式为 ISO 8601 日期时间字符串。
Id	created_by.id	string	此用户的唯一标识符。
Id	last_edited_by.id	string	此用户的唯一标识符。
网址	cover.url	string	链接到外部托管映像。
表情符号	icon.emoji	string	表情符号字符。
database_id	parent.database_id	string	database_id
存档	archived	boolean	页面的存档状态。
URL	url	string	“概念”页的 URL。

检索页面属性项

操作 ID:: Retrieveapagepropertyitem

检索页面属性项

参数

名称	密钥	必需	类型	说明
页面 ID	page_id	True	string	“概念”页的标识符
属性 ID	property_id	True	string	页面属性的标识符

名称	路径	类型	说明
物体	object	string	始终列出。
拥有更多内容	has_more	boolean	当响应包含列表末尾时，为 false。否则为 true。

追加块子级

操作 ID:: Appendblockchildren

创建新子块并将其追加到指定的父级block_id。

参数

名称	密钥	必需	类型	说明
块 ID	block_id	True	string	块的标识符
对象	object		string	对象
类型	type		string	类型
类型	type		string	类型
内容	content		string	内容
类型	type		string	类型
内容	content		string	内容
网址	url		string	网址

定义

CommentResponse

名称	路径	类型	说明
Id	id	string	注释的唯一标识符。
页 ID	parent.page_id	string	此页面所属的页面的 ID。
讨论 ID	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	批注的内容，支持格式文本格式、链接和提及。
类型	rich_text.type	string	类型
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
物体	results.object	string	页面或“数据库”
Id	results.id	string	数据库的唯一标识符。
创建时间	results.created_time	string	创建此数据库的日期和时间。格式为 ISO 8601 日期时间字符串。
上次编辑时间	results.last_edited_time	string	更新此数据库的日期和时间。格式为 ISO 8601 日期时间字符串。
物体	results.created_by.object	string	创建数据库的用户。
Id	results.created_by.id	string	用户的唯一标识符
物体	results.last_edited_by.object	string	创建数据库的用户。
Id	results.last_edited_by.id	string	用户的唯一标识符
已存档	results.archived	boolean	数据库的存档状态。
URL	results.url	string	Notion 数据库的 URL

通过

概念 （独立出版商）

正在创建连接

违约

限制

操作

创建注释

参数

返回

创建页面

参数

返回

删除块

参数

返回

所有用户列表

参数

返回

搜寻

参数

返回

更新块

参数

查询数据库

参数

返回

检索令牌的机器人用户

返回

检索块

参数

返回

检索块子级

参数

返回

检索数据库

参数

返回

检索注释

参数

返回

检索用户

参数

返回

检索页面

参数

返回

检索页面属性项

参数

返回

追加块子级

参数

定义

CommentResponse

DatabaseResponse

概念（独立出版商）