资源工坊

云文档业务域概述 ​

云文档介绍 ​

云文档指WPS提供的在线文档。企业可以在线创建文档，或将本地文件上传到云端空间。在保证企业文档集中存储、安全管控的同时，更可实现多端同步、多人在线协作编辑，大大提高了日常工作效率。

云文档也提供了较为全面的WPS 365 OpenAPI，通过接口对接，可以实现的功能不限于：

  • 创建文件存储空间

  • 上传、下载、复制、移动云端文件

  • 分享文件

  • 管理文件权限

  • ...

名词解释 ​

驱动盘 ​

驱动盘，即Drive（drive_id）是组织文件的基本单元，可以理解为文件空间，如团队空间。一个文件只能存在一个驱动器里。

UEPN5XBBACABC

文件 ​

文件，即file（file_id）是一个广义的概念，包含文件、文件夹或每一个在驱动盘中存储的单位。file_id用【字符串】的形式返回，是一个混合的id(UniqueID)

file_id还可以指 父目录id（parent_id），如果是根目录parent_id 可以传“0”

GTM55XBBACQB2

身份归属 ​

身份归属，即Allotee，是用来描述一个身份，通常用于说明驱动盘的归属，一般以allotee_id和allotee_type成对出现。allotee_id内容取决于allotee_type，也就是说allotee_type分别为user（用户）/group（用户组）/app（应用）时， allotee_id为user_id/group_id/app_id。

团队盘、个人盘、应用盘 ​

  • 团队盘：盘的归属是用户组，即allotee_type=group。用户组中的成员可以根据对应权限操作团队盘中的文件。团队盘和用户组组成文档库，通常展示在这里
LY2UVHBAAAQBA

  • 个人盘：盘的归属是用户，allotee_type=user。个人盘是用户自己持有的驱动盘，其他人只能通过分享链接访问其中的文件，最常见的就是“我的云文档”，人手一份。

  • 应用盘：盘的归属是应用，allotee_type=app。应用盘与个人盘类似，是应用身份自己持有的驱动盘，其他人只能通过分享链接访问其中的文件。应用盘目前还没有UI展示界面，只能通过接口层面进行操作。

文档库 ​

文档库是用户组与驱动盘的结合，可以理解为“团队文档”，既有成员，也可以操作文档。

  • 文档库、驱动盘、用户组 他们之前关系是这样：

    • 如果想在群组中和成员一起操作文件，就可以直接创建文档库， 这时就拥有一个 文档库1（包含了一个用户组和一个驱动盘）

    • 如果一开始只想创建一个成员集合，不涉及文件操作，可以先创建一个用户组，这时就拥有一个 用户组2

    • 如果已经有了用户组，需要对文件进行操作了，可以在用户组2下新建驱动盘，这时就拥有一个 文档库2

  • 文档库列表对应的UI界面展示在这里

XB3QZXJBADQGO
  • 只有企业普通用户身份可以创建文档库，即通过接口调用时，需要使用用户授权。应用身份只能创建用于存放文件的应用盘，不能创建文档库。