云空间常见问题

1. 如何获取文件夹、文件以及各种类型的云文档的 token 信息？

列1
### 文件夹 token 获取方式 你可通过以下两种方式获取文件夹的 token： - 如下图，在浏览器中打开文件夹，在地址栏中获取文件夹的 token。 - 调用开放平台接口获取： - 调用获取我的空间（root folder）元数据接口获取根目录（即根文件夹）的 token。 - 继续调用获取文件夹中的文件清单接口，获取根目录下文件夹的 token。 ### 文件 token 获取方式 你可通过以下两种方式获取文件的 token： - 如下图，在浏览器中打开文件，在地址栏中获取文件的 token。 - 调用开放平台接口获取： - 调用获取我的空间（root folder）元数据接口获取根目录（即根文件夹）的 token。 - 继续调用获取文件夹中的文件清单接口，获取根目录下文件的 token。 ### 素材 token 获取方式 飞书开放平台支持在在线文档、电子表格、多维表格中上传和下载素材。在不同的云文档中，素材 token 的获取方式不同。具体方式如下所示：
html

  素材所在文档类型  
  素材 token 获取方式  
 


 
  
    在线文档

通过获取文档所有块接口获取指定文件块（File Block）或图片块（Image Block）等块的信息，其中的 token 参数即为素材的 token。

    电子表格

通过读取多个范围接口获取指定附件的 fileToken 参数，即为素材的 token。

    多维表格

通过查询记录接口获取指定附件的 file_token参数，即为素材的 token。

2. 如何为应用身份（tenant_access_token）开通个人云空间中文件夹的查看或编辑权限？

列1
要允许应用访问个人云空间中的文件夹，参考以下步骤： 1. 访问飞书开放平台开发者后台，选择目标应用。 1. 在应用管理页面，点击添加应用能力，找到机器人卡片，点击 +添加。 1. 在飞书客户端，创建一个新的群组，将应用添加为群机器人。 1. 在 云文档 > 云盘中找到对应的文件夹，将文件夹分享给刚刚新建的群组。

3. 如何为应用身份（tenant_access_token）开通文件、素材的下载权限?

列1
要分享文件、素材的下载权限给应用，参考以下步骤： 1. 访问开发者后台，选择目标应用。 1. 在应用管理页面，点击添加应用能力，找到机器人卡片，点击 +添加。 1. 根据分享的文件是否位于文件夹中，选择不同的开通权限方式： - 如果文件或素材不在文件夹中： 文档所有者、知识库管理员 或 其他协作者 将应用添加为文档协作者。 - 如果文件或素材位于文件夹中： 1. 在飞书客户端，创建一个新的群组，将应用添加为群机器人。 2. 在 云文档 > 云盘中找到对应的文件夹，将文件夹分享给刚刚新建的群组。默认情况下，可阅读用户拥有当前文件的下载权限。 4. 如果应用已经是文档协作者，但仍无文件、素材的下载权限，请进一步查看素材所在的云文档或文件的权限设置面板中关于谁可以创建副本、打印和下载的设置，确认应用已在允许的权限范围内。

4. 云文档支持一次性将文件夹、子文件夹、和子文件夹中的文件同时上传至云盘吗？

列1
不支持。你可以调用新建文件夹接口创建文件夹和子文件夹，再调用上传文件接口将文件一个个上传至对应文件夹中。

5. 云文档是否支持批量指定文档的所有者？

列1
不支持。你需要通过转移所有者接口一个个指定并转移所有者。