Notion API 连接

在此帮助文档中

通过 Notion 的 API,你将能够创建自定义内部连接。我们的一些合作伙伴可能还需要内部连接令牌,才能将他们的平台链接你的 Notion 工作空间——下面,我们将指导你如何设置。


访问我们的 开发者中心 获取文档、资源和连接管理工具。

注意: 工作空间所有者管理工作空间中的所有连接。了解更多,点击 此处 →

  1. 在左侧边栏中,导航至 设置,然后点击 连接 选项卡。

  2. 只有工作空间所有者才能访问 连接 选项卡并创建集成。如果你不是管理员,请联系你的工作空间管理员,或使用其他工作空间。

  3. 点击底部的 开发你自己的连接 链接。

  4. 我的连接 将在你的默认浏览器中打开。点击 + 新建 按钮。

  5. 为你的连接提供一个 名称。你也可以选择上传一张图片作为 徽标

  6. 使用下拉菜单指定你希望将此连接用于哪个 关联工作空间

    注意: 请确保你在网页会话中登录 Notion 时所使用的帐号与桌面端使用的帐号相同。否则,你将无法看到正确的帐号和工作空间!

  7. 你的内部连接已成功添加!你现在可以在工作空间的 设置 菜单 → 连接 中看到它。

  8. 点击内部连接旁边的 ••• 以获取内部连接令牌。你在团队创建任何基于 API 的自动化或工作流程时,或者将工作空间链接到某些合作伙伴平台时,都需要此令牌。

注意: 内部连接是工作空间特定的,因此要更改关联的工作空间,你必须创建一个新的连接.

所有新添加的连接最初都是内部连接。如果你是正在开发公共连接的开发者,请先按照上述指令创建内部连接。

然后,按照我们 开发者使用手册 中的说明将其转换为公共连接。

在应用设置过程中,开发者将能够选择用户所需的访问权限级别。

  • 内容功能:

    • 仅读取内容

    • 仅写入内容

    • 插入内容

  • 用户功能

    • 没有用户信息

    • 读取用户信息(不包括用户的电子邮件地址)

    • 读取用户信息(包括电子邮件)

当用户安装连接时,将显示此访问级别。它还会显示在已添加该连接的任何页面的 共享 菜单中。了解更多关于在工作空间中安装连接的信息 →

连接 Webhook 使连接能够实时监控 Notion 工作空间中的更改并做出响应。

当与你的 连接 共享的页面或数据库发生更改时,Notion 会自动向你的 Webhook 端点发送通知,从而允许你的连接立即更新其他工具、运行自动化任务或显示最新更改。

设置连接 Webhook

有关说明,请访问我们的 开发者文档

连接 Webhook 目前不支持以下通知:

  • 用户更改(包括工作空间成员资格更改、电子邮件/姓名更新以及权限修改)。

  • 工作空间和团队协作区设置更改.

对于这些类型的通知,请改用 审计日志

Webhook 操作 vs. 连接 Webhook

Webhook 操作与连接 Webhook 有一些相似之处——两者都有触发器,并且可以将事件发送到第三方服务。但是,连接 Webhook 提供了更广泛的功能:

  • 它们可以监控多个工作空间中的活动。

  • 它们可以处理无限数量的操作。

相比之下,Webhook 操作专为更简单的用例而设计,并通过具有有限触发器集的数据库自动化进行配置。


给予反馈

这个资源有帮助吗?


Powered by Fruition