跳到主要内容

使用 API 添加和管理连接

使用 API 添加和管理集成 - 主图

通过我们的 API,您可以将其他软件连接到 Notion,自动化工作区内的操作,并访问由合作伙伴构建的连接 🤖

目录

  • 在您的工作区中添加连接
  • 将连接添加到页面
  • 在您的工作区中管理连接
  • 企业级连接设置
  • 限制成员安装连接
  • 自动批准 Notion 构建的连接
  • 已批准的连接列表
  • 从开发者处安装
  • 通过 OAuth 直接从合作伙伴平台安装
  • 使用内部集成令牌进行安装

想要使用 Notion 的 API 构建强大的工作流程和集成吗?请访问我们的 开发者中心 获取文档、资源和集成管理工具。

注意: 在企业计划中,以下功能可能仅限工作区所有者使用:

在您的工作区中添加连接

成员可在 设置与成员我的连接 中添加连接。
工作区所有者可在 设置与成员连接 中添加连接。

一旦添加,该连接即可被添加到更多页面。

将连接添加到页面

使用 API 构建的连接遵循与 Notion 用户共享权限类似的权限系统。
要在工作区中使用连接,需将其添加至具体页面。

  1. 导航至目标页面,点击右上角的 •••
  2. 在弹出窗口底部点击 Add connections
  3. 搜索并选择要添加到此页的连接。
    仅显示已为该工作区创建并关联的连接。

add connection menu

  • 添加后,该连接将出现在页面的 ••• 菜单中。
  • 若要移除连接,悬停其名称,点击 断开连接

管理工作区中的连接

注意:工作区所有者 可管理工作区中的所有连接。成员只能管理自己创建的连接。

  • 在左侧边栏中,进入 设置和成员Connections
  • 此处包含两个选项卡:成员工作区

成员选项卡
管理成员可访问的集成:

  • 限制集成访问权限至已批准列表
  • 查看谁在使用内部集成
  • 断开任意集成的使用

仅企业工作区所有者可限制访问至已批准列表。

工作区选项卡
安装和管理适用于整个企业工作区的安全与合规性集成。

添加和管理集成 - 集成菜单

点击连接旁的 •••,可执行以下操作:

  • 检索内部 API 令牌
  • 访问开发者网站或联系支持
  • 查看有权访问的用户
  • 断开连接

企业连接设置

企业计划的工作区所有者可使用额外设置管理连接。

限制成员安装连接

  • 作为工作区所有者,进入 设置与成员Connections
  • Member 标签下,找到选项:Restrict members from adding connections
  • 点击右侧下拉菜单,选择:
    • No restrictions:所有成员可安装任意连接。
    • Only from approved list:成员仅可安装工作区所有者预先批准的连接。

      若所有者安装了未在批准列表中的集成,它将自动加入列表。

集成 - 企业菜单

自动批准 Notion 构建的连接

  • 若选择 “仅限已批准列表”,将出现额外选项:自动批准由 Notion 构建的连接
    查看完整列表 →

集成 - 自动批准

已批准的连接列表

  • 点击 + 添加已批准的连接,为成员批准其他连接。

注意: 必须先由您或管理员安装该连接,才能将其加入批准列表。
仅已安装在工作区中的连接会出现在下拉菜单中。

安装后,您将在 “已批准的连接” 标题下看到完整列表,包含:

  • 已批准且已安装的所有连接
  • 每个连接右侧列出已安装该连接的用户姓名

点击 ••• 菜单可执行:

  • 按用户筛选
  • 撤销特定用户的访问权限
  • 断开所有用户
  • 从批准列表中移除该连接

集成选项

从开发者处进行安装

查看我们的集成画廊 →

直接通过 OAuth 从合作伙伴平台安装

Notion 与多个服务(如 ZapierTypeform)深度合作。
您可通过 OAuth 直接在这些平台网站上将合作伙伴的公共连接添加至工作区。

  • 在合作平台的应用菜单中搜索 Notion 并添加。
  • 在身份验证界面,连接将请求访问您的工作区,并明确所需权限级别。
  • 连接绑定至特定工作区。如需切换,点击右上角工作区名称,再点 选择页面

添加和管理集成 - OAuth

  • 选择该连接可访问的页面,点击 允许访问
  • 完成验证后,连接将出现在 设置和成员Connections 中。
  • 点击连接名称旁的 •••,可访问开发者网站、联系支持或断开连接。

添加和管理集成 - 公共集成菜单

提示: 想了解合作伙伴集成的实际效果?查看此指南 →

通过内部集成令牌安装

部分合作伙伴平台需使用内部集成令牌连接至您的工作区。

  • 首先,按说明为您的工作区创建对应的内部集成。
  • 完成后,进入侧边栏 设置和成员连接
  • 点击目标连接旁的 •••,选择 复制内部集成令牌

添加和管理集成 - 内部集成令牌

  • 将令牌粘贴至合作伙伴平台设置表单的对应字段。

注意: Notion 不负责解决第三方集成问题。如有疑问,请直接联系相关合作方支持团队。