资源介绍

资源定义

单位是单个租户内部用于表征大型集团企业中的“子公司”、“分支机构”的组织实体，一个“单位”可以被理解为现实世界中一个集团企业的‘子公司’，单位目前的主要作用是在部分用户权限上实现“子公司”级别的权限隔离。了解更多

如下场景已支持按单位管控：

组织架构可见范围支持设置为”员工可见本单位组织架构“。

名片页字段可见范围支持设置名片页某字段”仅限本单位内员工可见“

用户名片页展示其归属单位

单位字段说明

名称	类型	描述
unit_id	string	租户内单位的唯一标识，可在创建单位时自定义，不自定义则由系统自动生成，已创建单位不允许修改 unit_id 。自定义`unit_id`数据校验规则：最大长度：`64` 字符校验规则：数字、大小写字母的组合，不能包含空格示例值："BU121"
name	string	单位的名字，企业内唯一最大长度：`100` 字校验规则：1-100 个字，企业内唯一示例值："消费者事业部"
unit_type	string	单位的类型名说明：自定义的单位类型名称，一个组织可以有多个不同单位类型，如子公司、事业部、BU

unit_id 说明

单位ID unit_id 用来标识租户内一个唯一的单位，支持在创建单位时自定义，若不自定义则由系统默认生成。已经创建的单位不允许修改 unit_id。

如果你的企业内部系统已有类似“单位”的实体并且希望同步到飞书，你可以在调用创建单位接口时将本企业内部系统已有的单位唯一标识写入到飞书的 unit_id 中，由此实现飞书单位 ID 和内部系统“单位” ID 的一致性，节省跨系统调用的映射成本。

数据示例

  {
    "code": 0,
    "msg": "success",
    "data": {
        "unit": {
            "unit_id": "BU121",
            "name": "消费事业部",
            "unit_type": "事业部"
        }
    }
}

资源定义#

单位字段说明#

unit_id 说明#

数据示例#

资源定义

单位字段说明

unit_id 说明

数据示例