1. 概述编辑
1.1 应用场景
1.2 功能简介
飞书云文档获取范围
除了「电子表格、多维表」以外,其他文件暂不支持获取
可获取的「电子表格、多维表格」需满足配置要求,详见下方【飞书可获取的文件配置要求】
1.3 授权流程
1)需要成员登录开发者后台,在开放平台中创建应用来获取 App ID 和 App Secret 信息;
2)
2. 获取授权信息编辑
2.1 创建自建应用获取 App ID 和 App Secret
1)登录开发者后台,点击「创建企业自建应用」,填写应用基本信息,并点击「创建」。如下图所示:
2)在权限管理下,先搜索「云空间」,勾选上云空间相关的权限。如下图所示:
3)同理,依次搜索「多维表格」、「电子表格」、「导出云文档」,并勾选上相关的权限。如下图所示:
4)上述权限勾选完成后,点击「批量开通」相关权限,并点击「确定并前往创建应用版本」。如下图所示:
5)跳转到「版本管理与发布」中,完成企业内部应用的线上发布。如下图所示:
注:非企业管理员创建应用并申请上线,需要企业管理员在管理后台中进行应用审核,详情参见文档:审核自建应用
6)在「凭证与基础信息」下,就可以获取到 App ID 和 App Secret 。如下图所示:
2.2 飞书文件的配置要求
2.2.1 注意事项
1)授权信息中还要获取文件的链接,若文件链接分享权限为「仅文档协作者可通过链接访问」,需要同时添加自建应用到当前文件中。请参考2.2.2 节进行操作;
2)其余链接分享权限不需要额外设置,可直接跳转到 2.3 节。
2.2.2 添加自建应用
1)非本人创建的自建应用,需要 管理员登录飞书管理后台 ,在管理后台中分配自建应用的使用权限后,其他成员才可在文件中添加应用。
2)点击进入电子表格/多维表格,点击「添加文档应用」。如下图所示:
3)在搜索栏中搜索 2.2 节中的自建应用,点击「添加」按钮。如下图所示:
2.3 自动获取文件夹中的文件
2.3.1 注意事项
1)若只需获取单个电子表格/多维表格中的数据,可直接跳转到 2.4 节;
2)若希望获取某一个文件夹中的所有文件,且想要实现文件夹内新增的文件自动同步到九数云,可以通过添加机器人来自动获取飞书文件夹内的所有文件;
3)仅自动获取「直接」放在绑定文件家中的表,子文件节内的表不会自动获取,如需使用请单独绑定子文件夹。
2.3.2 配置机器人
1)登录开发者后台,进入 2.1 节的自建应用中,在该应用中添加「机器人」。如下图所示:
2)当前的配置发生了变化,点击「创建版本」,填写相关信息后,申请线上发布新版本,使当前的修改生效。如下图所示:
3)
获取链接
1)