权限范围详解

功能简介

通讯录权限范围 定义了应用调用通讯录接口能获取哪些部门和用户数据，不在应用获取通讯录范围内的数据是无法访问的。

注意：

商店应用无法修改用户所在企业的通讯录信息。

默认情况下，通讯录权限范围与应用的可用范围一致。

修改通讯录权限范围后，需要创建应用版本，由管理员审核通过后才可生效。

通讯录数据访问范围需要配合通讯录权限才可生效，请注意在权限配置中申请 通讯录 板块下必要的权限。

举例来说：假设通讯录中有 A、B、C 三个部门，若一个应用只有 B 和 C 两个部门的通讯录权限，那么该应用就只能通过接口获取到 B 和 C 两个部门的数据，获取 A 部门就会报出没有权限的错误。

相关概念

应用可用范围

应用可用范围定义了哪些人可以使用该应用，由安装该应用的租户管理员或超级管理员在管理后台设置，可以按部门、用户组、用户设置。如果企业希望应用服务于哪些人就可以获取哪些人的数据，则通过在后台打开与可用人员范围保持一致实现应用获取通讯录权限范围同步自应用可用范围，届时，应用的获取通讯录权限范围将和应用可用范围完全一致，不可单独修改。

组织架构可见范围

组织架构可见范围定义了用户在飞书 > 通讯录 > 组织架构中可见的组织架构范围，由租户管理员在管理后台 > 安全 > 用户权限 > 组织架构可见范围中设置，可以理解为针对用户的通讯录可访问范围管控，而应用“获取通讯录权限范围”是针对应用的通讯录可访问范围，二者不是一个维度的管控。

应用案例

小王开发了一个人力管理相关的自建应用。出于数据保密的要求，这个应用只能被 HR 同事使用。但由于应用需要管理全公司的人事信息，需要获取全公司的通讯录数据。
小王可以将这个应用的可用范围设置为 HR 部门的同事，同时申请应用的通讯录权限范围为全部成员。应用管理员审核通过后，这个人力管理应用就可以控制比较小的可用人员范围，同时又能获得全公司的通讯录数据了。

权限范围分类

用户通讯录范围权限

只要有一个部门的通讯录范围权限，那么就拥有这个部门下所有用户的权限。

需要用户通讯录范围权限的接口有：

用户的 delete、update、patch、get 方法。

用户组成员的添加和删除方法。

部门通讯录范围权限

新版的通讯录中，将部门的通讯录权限细化为父部门权限和部门权限两种。只要有一个部门的通讯录范围权限，那么就拥有这个部门下所有子部门的权限。

需要父部门通讯录范围权限的接口有：部门的create、delete、list、update、patch、parent方法。

需要部门通讯录范围权限的接口有：

部门的delete、update、patch、get 方法。

用户的create、delete、update、patch、list方法。

全员权限

全员权限就是拥有通讯录下所有数据的权限。以下几种情况需要拥有全员权限：

资源	方法	方法描述
部门	`create`	在根部门上创建子部门
部门	`update`和`patch`	将父部门更新为根部门
部门	`list`	获取根部门下的子部门
部门	`delete`	删除根部门下的子部门
部门	`get`	获取根部门信息
用户	`create`	在根部门下创建用户
用户	`delete`	删除根部门下的用户
用户	`update`和`patch`	将所属部门更新为根部门
用户	`list`	获取根部门下的用户
用户组	`create`	创建用户组

设置方式

租户管理员设置通讯录权限范围

由租户超级管理员或安装该应用的租户管理员在管理后台 > 工作台 > 应用管理进入某应用配置详情页进行设置。

具体设置方法参见下图：

应用开发者设置通讯录权限范围

可以在开发者后台 > 打开你的应用 > 权限管理面板中设置通讯录权限范围。具体设置方法参见下图：

功能简介#

相关概念#

应用可用范围#

组织架构可见范围#

应用案例#

权限范围分类#

用户通讯录范围权限#

部门通讯录范围权限#

全员权限#

设置方式#

租户管理员设置通讯录权限范围#

应用开发者设置通讯录权限范围#