常见问题

根据右侧导航栏中的标题可快速查找相关问题

1. 什么是应用权限？

「应用权限」是企业自建应用或应用商店应用享有调用云文档 API 接口的权限。需要 企业管理员 审批。

2. 访问云文档资源需要开启哪些应用权限？如何申请？

根据操作的资源类型选择申请合适的应用权限，如何申请应用权限，常见权限列表：查看、评论、编辑和管理云空间中所有文件查看、评论、编辑和管理文档查看、评论、编辑和管理电子表格查看、评论、编辑和管理多维表格查看、编辑和管理知识库

3. 什么是文档权限？文档协作者？如何添加？

「文档权限」是应用需要操作的云文档资源，如文件夹、文档、电子表格、多维表格、知识库等资源的「可阅读」和「可编辑」权限。通过添加用户（应用）为 文档协作者 来获得「文档权限」添加用户、群组或部门为文档协作者需要 文档所有者、知识库管理员 或 其他协作者 分享权限。文件夹、文档、电子表格、多维表格、知识库通过云文档 Web 页「分享」入口添加。添加应用为文档协作者需要 文档所有者、知识库管理员 或 其他协作者 为资源 添加文档应用。文档、电子表格、多维表格、知识库通过云文档 Web 页面右上方「...」->「...更多」-> 「添加文档应用」入口添加。

4. 应用权限与文档权限的区别？

「应用权限」拦截非法应用（未通过企业管理员授权）调用云文档 API 获取云文档资源。「文档权限」拦截非法用户（未获取文档所有者授权）获取云文档资源。

5. 遇到权限错误的排查建议？

确定当前使用访问凭证是 user_access_token 还是 tenant_access_token。确认当前身份是否拥有访问目标的「文档权限」。参考本页 问题3。确认「应用权限」是否已申请。参考本页 问题2。

6. 云文档资源相关 token（id）和 type 说明？

云文档资源的 token（id） 是资源的标识， type 是资源的类型。调用公共接口的时候资源需要通过 token + type 唯一确定，token 和 type 需要正确匹配（不匹配接口会调用失败）。资源标识 - token（id）：云空间：root_token文件夹：folder_token文件：file_token文档：doc_token新版文档：document_id电子表格：spreadsheet_token多维表格：app_token知识空间：space_id节点：node_tokenobj_token：关联以下其中一种资源file_tokendoc_tokendocument_idspreadsheet_tokenapp_tokenmindnote_token资源类型 - type：文件夹：folder文件：file文档：doc新版文档：docx电子表格：sheet多维表格：bitable思维笔记：mindnote

7. 如何获取云文档资源相关 token（id）？

通过浏览器地址栏获取 token (以下红色部分)（注意： 拷贝时 URL 末尾可能多余的 “#”）文件夹 folder_token： https://sample.feishu.cn/drive/folder/cSJe2JgtFFBwRuTKAJK6baNGUn0文件 file_token：https://sample.feishu.cn/file/ndqUw1kpjnGNNaegyqDyoQDCLx1文档 doc_token：https://sample.feishu.cn/docs/2olt0Ts4Mds7j7iqzdwrqEUnO7q新版文档 document_id：https://sample.feishu.cn/docx/UXEAd6cRUoj5pexJZr0cdwaFnpd电子表格 spreadsheet_token：https://sample.feishu.cn/sheets/MRLOWBf6J47ZUjmwYRsN8utLEoY多维表格 app_token：https://sample.feishu.cn/base/Pc9OpwAV4nLdU7lTy71t6Kmmkoz知识空间 space_id（知识库管理员打开设置页面）：https://sample.feishu.cn/wiki/settings/7075377271827264924知识库节点 node_token：https://sample.feishu.cn/wiki/sZdeQp3m4nFGzwqR5vx4vZksMoe通过开放平台接口获取「**云空间**」资源的 token 和 type 获取通过文件管理获取根文件夹 root_token 。通过文件管理获取文件夹列表清单获取各种资源的 token 和 type。再通过文档、电子表格、多维表格API 读写文档内容数据。「知识库」资源的 token 和 type 获取通过知识库获取知识空间列表获取 space_id。通过知识库获取子节点列表获取 node_token。通过知识库获取节点信息获取各种资源的 obj_token 和 obj_type。再通过文档、电子表格、多维表格API 读写文档内容数据。「文档」中嵌入的电子表格 spreadsheet_token (多维表格 app_token) 获取通过获取文档富文本内容返回文档中嵌入的电子表格 spreadsheet_token 和 tableId (多维表格 app_token 和 tableId) 。例如：电子表格（“” 前面是 spreadsheet_token，后面是 tableId） MRLOWBf6J47ZUjmwYRsN8utLEoY_m7fMrN多维表格（“” 前面是 app_token，后面是 tableId） Pc9OpwAV4nLdU7lTy71t6Kmmkoz_tblC63QuAGFOJkU9「电子表格」中嵌入的多维表格 app_token 获取通过获取表格元数据返回电子表格中嵌入的多维表格 app_token 和 tableId 。例如：多维表格（“_” 前面是 app_token，后面是 tableId） Pc9OpwAV4nLdU7lTy71t6Kmmkoz_tbliITl3F8GXBtKw

8. 如何使用应用身份（tenant_access_token）访问云文档资源？

通过应用 App ID 和 App Secret 获取企业自建应用 tenant_access_token(或应用商店应用 tenant_access_token)。更多参考获取应用身份访问凭证.申请「应用权限」。参考本页 问题2。访问应用自有资源。获取云空间根文件夹 root_token、调用新建文件夹接口创建文件夹、调用创建文档接口创建文档（文档、电子表格、多维表格）。调用获取文件夹下文件清单接口查看文件目录下内容。调用复制文件、移动文件、删除文件管理「应用云空间」访问应用非自有资源。参考本页 问题3 添加应用为文档协作者调用获取文档纯文本内容、编辑文档内容。调用获取电子表格元数据获取到 sheetId，获取电子表格数据、写入电子表格数据。调用多维表格列出数据表获取到 tableId，列出记录获取数据、更新记录修改数据。

9. 如何使用用户身份（user_access_token）访问云文档资源？

通过应用 App ID 和 App Secret 获取企业自建应用 tenant_access_token(或应用商店应用 tenant_access_token)。更多参考获取应用身份访问凭证。获取 CODE 前需要先配置重定向域名,再通过用户登录预授权码获取 CODE。（CODE 只能使用一次，每次使用前需要重新获取）通过第1步获取的 tenant_access_token 和第2步获取的 CODE 调用获取登录用户身份 user_access_token获取到 user_access_token。更多参考获取用户身份登录凭证。申请「应用权限」。参考本页 问题2。访问用户自有资源。获取云空间根文件夹 root_token、调用新建文件夹接口创建文件夹、调用创建文档接口创建文档（文档、电子表格、多维表格）。调用获取文件夹下文件清单接口查看文件目录下内容。调用复制文件、移动文件、删除文件管理「我的空间」访问用户非自有资源。参考本页 问题3 添加用户、群组或部门为文档协作者调用获取文档纯文本内容、编辑文档内容。调用获取电子表格元数据获取到 sheetId，获取电子表格数据、写入电子表格数据。调用多维表格列出数据表获取到 tableId，列出记录获取数据、更新记录修改数据。

10. 如何获取应用 open_id？

有三种方式获取应用的 open_id, 可自行选择合适的方式：通过获取机器人信息，需要应用启用机器人能力。通过获取元数据返回资源的所有者先用应用身份（tenant_access_token）新建文件。再调用获取元数据接口获取该文档 owner_id。通过获取协作者列表先手动将应用添加为一篇文档的协作者，参考本页问题3 添加应用为文档协作者。再通过文档所有者的（user_access_token）身份凭证获取协作者列表。

11. 如何获取群组 chat_id？

有两种方式获取群组 chat_id, 可自行选择合适的方式：通过获取协作者列表先手动将群组添加为一篇文档的协作者，参考本页问题3 添加用户、群组或部门为文档协作者（添加时选择群组）。再通过文档所有者的（user_access_token）身份凭证获取协作者列表。通过获取用户或机器人所在的群列表。需要应用启用机器人能力打开飞书群组聊天窗口将应用添加为群机器人。再调用获取用户或机器人所在的群列表获取这个应用所在的群组 chat_id。

1. 什么是应用权限？#

2. 访问云文档资源需要开启哪些应用权限？如何申请？#

3. 什么是文档权限？文档协作者？如何添加？#

4. 应用权限与文档权限的区别？#

5. 遇到权限错误的排查建议？#

6. 云文档资源相关 token（id） 和 type 说明？#

7. 如何获取云文档资源相关 token（id）？#

8. 如何使用应用身份（tenant_access_token）访问云文档资源？#

9. 如何使用用户身份（user_access_token）访问云文档资源？#

10. 如何获取应用 open_id？#

11. 如何获取群组 chat_id？#