权限范围资源介绍
什么是通讯录权限范围
| 人员类型 | 配置场景 |
|---|---|
| 应用开发者 | 应用开发者可以在开发者后台的应用详情页内，配置应用的通讯录权限范围。以企业自建应用为例，需要进入应用详情页的 开发配置 > 权限管理 页面。添加方式分为以下两种：方式一：点击 开通权限，开通通讯录权限时，页面会自动跳转到通讯录权限范围的配置页面，点击 配置 即可自定义配置。配置完成后需要点击右下角 确定。 方式二：如果 API 权限列表已经添加了通讯录权限，则可以点击 可访问的数据范围 列字段右侧的 配置，跳转到通讯录权限范围的配置页面进行配置。 商店应用无法修改用户所在企业的通讯录信息。默认情况下，通讯录权限范围与应用的可用范围一致。修改通讯录权限范围后，需要创建应用版本，由管理员审核通过后才可生效。通讯录数据访问范围需要配合通讯录权限才可生效，请注意在应用的 权限配置 > API 权限 中申请通讯录相关的 API 权限。 |
| 企业管理员 | 企业管理员可以在管理后台 > 工作台 > 应用管理 页面，进入指定应用管理页，然后管理应用的 通讯录设置。 |
相关概念
应用可用范围
用户组织架构可见范围
权限生效规则
| 类型 | 规则说明 |
|---|---|
| 用户通讯录范围的权限 | 调用 API 的应用或者用户身份，只要有一个部门的通讯录范围权限，那么就拥有该部门下所有用户的权限。需要配置用户通讯录范围权限的接口有：用户：获取单个用户信息批量获取用户信息搜索用户恢复已删除用户修改用户部分信息删除用户用户组成员：添加用户组成员批量添加用户组成员移除用户组成员批量移除用户组成员 |
| 部门通讯录范围的权限 | 通讯录将部门的通讯录权限细化为父部门权限和部门权限两种。调用 API 的应用或者用户身份，只要有一个部门的通讯录范围权限，那么就拥有这个部门下所有子部门的权限。需要父部门通讯录范围权限的接口有：创建部门获取单个部门信息批量获取部门信息获取子部门列表获取父部门信息修改部门部分信息更新部门所有信息删除部门需要部门通讯录范围权限的接口有：部门：获取单个部门信息批量获取部门信息获取子部门列表获取父部门信息修改部门部分信息更新部门所有信息删除部门用户：创建用户获取部门直属用户列表恢复已删除用户修改用户部分信息删除用户 |
| 全员权限 | 全员权限是指拥有通讯录下所有数据的权限。需要拥有全员权限的场景，可参见下文 全员权限说明表。 |
| 资源 | 接口 | 场景说明 |
|---|---|---|
| 部门 | 创建部门 | 在根部门下创建子部门 |
| 部门 | 获取单个部门信息批量获取部门信息获取子部门列表 | 获取根部门下的子部门列表 |
| 部门 | 获取父部门信息 | 获取根部门的信息 |
| 部门 | 修改部门部分信息更新部门所有信息 | 将部门的父部门更改为根部门 |
| 部门 | 删除部门 | 删除根部门下的子部门 |
| 用户 | 创建用户 | 在根部门下创建用户 |
| 用户 | 获取部门直属用户列表 | 获取根部门下的用户列表 |
| 用户 | 修改用户部分信息恢复已删除用户 | 将用户所属部门配置为根部门 |
| 用户 | 删除用户 | 删除根部门下的用户 |
| 用户组 | 创建用户组 | 创建用户 组时，应用需要有全员通讯录权限。 |
典型案例
方法列表
扫码加入交流群修改于 2025-10-20 09:04:56