使用 Notion API 创建集成
通过 Notion 的 API，您可以创建自定义的内部集成。
某些合作伙伴可能需要一个 内部集成令牌，以便将其平台与您的工作区连接。
下方将介绍如何设置该令牌 🏗️
目录
- 创建一个内部集成
- 创建一个公共集成
- 细粒度的集成权限
访问我们的 开发者中心，获取文档、资源和集成管理工具。
创建内部集成
- 在左侧边栏中，进入
设置与成员→集成选项卡。 - 仅 工作区所有者 可访问此选项卡并创建集成。
若非管理员，请联系工作区管理员，或切换至您拥有权限的工作区。 - 点击底部的 Develop your own integrations 链接。
- 我的集成 页面将在浏览器中打开。点击 + 新建集成功能（New integration）。
注意： 请确保网页端登录的账户与桌面端一致。否则可能无法看到正确的工作区。
- 为集成填写 名称（Name）。
可选：上传一张图片作为 标志（Logo）。 - 使用下拉菜单选择 关联工作区（Associated workspace）。
注意： 内部集成绑定特定工作区。如需更换工作 区，请创建新集成。
- 集成创建成功！
现在可在设置和成员→我的集成中查看。
- 点击集成旁的
•••，获取 内部集成令牌。
该令牌用于：- 构建基于 API 的自动化流程
- 将工作区连接至合作伙伴平台
创建公共集成
所有新集成默认为内部使用。
若您正在开发 公共集成，请先按上述步骤创建内部集成。
随后，参照 开发人员指南 将其转为公共集成。
细粒度的集成权限
在应用配置阶段，开发者可选择所需的用户访问级别。
内容权限：
- 仅读取内容
- 仅写入内容
- 插入内容
用户权限：
- 无用户信息
- 读取用户信息（不含邮箱）
- 读取用户信息（含邮箱）
用户安装集成时，将看到所选访问级别。
该信息也会显示在已添加集成的任意页面的 共享 菜单中。
了解如何管理工作区中的集成 →