有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

媒资授权

默认情况下,用户只能访问自身或者其所加入团队的媒资库,而不能访问其他用户或者其未加入团队的媒资库。要突破这一限制,就必须引入授权体系。 授权操作由如下元素构成:
元素
说明
授权者(Authorizer)
用户可以将其自身媒资库中的分类或者媒体授权给其他用户或团队,此时授权者为该用户。团队的 Owner 或者 Admin 可以将团队资源授权给其他用户或团队,此时授权者为该团队(注意此时授权者不等于操作者)。
被授权者(Authorizee)
被授予权限的用户或者团队。当被授权者为团队时,相当于对该团队的所有成员进行授权(如某一成员退出团队则不再享受授权)。
资源(Resource)
授权者分类树下的某一个媒体,或者某一个分类。
权限(Permission)
系统预设四种权限,详情请参见 预设权限;开发者亦可自定义权限。
注意
授权不具备传递性,即:用户不能将其他用户授权给自己的媒体进一步授权给第三方。

预设权限

以下是预设权限参数解读:
参数
说明
R(可读)
被授权者可以读取被授权媒体的基本信息,浏览被授权分类,但不能将媒体到自己的媒资库,也不能使用该媒体(例如将其添加到在线编辑项目中)。
X(可用)
被授权者可以读取被授权媒体的基本信息,浏览被授权分类,可以使用该媒体(例如将其添加到在线编辑项目中),但不能将其复制到自己的媒资库中。当授权被取消之后,被授权者将无法再使用该素材。
C(可复制)
被授权者可以将该素材复制到自身媒资库中,从而创建一份该素材的副本,并以任意方式操作该副本。当授权被取消之后,被授权者对素材副本的操作权限不受影响。
W(可修改)
被授权者可以修改、删除得到授权的媒体或分类。

操作指南

操作
服务端 API
对资源进行授权
获取资源授权列表
撤销授权

共享空间

当用户被授予某些资源的访问权限时,其需要一个统一的入口来列出这些资源。共享空间(SharedSpace)正是为了解决这一问题而设计的,它的目的是让用户可以获知哪些用户或团队对该用户授予了哪些资源。用户在其共享空间中可以看到:
哪些用户或团队对该用户存在资源授权。
哪些用户或团队对该用户所在的团队存在资源授权。
每一个授权操作都将产生一个共享根。如果被授权资源为单个媒体,则共享根为媒体文件本身。如果被授权资源是一个分类,则共享根为该分类,被授权者可以遍历该分类及其子分类下的所有媒体。

操作指南

操作
服务端 API
获取共享空间