public class Department extends Object
| 构造器和说明 |
|---|
Department(Config config) |
| 限定符和类型 | 方法和说明 |
|---|---|
CreateDepartmentResp |
create(CreateDepartmentReq req)
创建部门，本接口用于用于在企业通讯录中创建新部门，支持设置部门名称、父部门、负责人等信息。
|
CreateDepartmentResp |
create(CreateDepartmentReq req,
RequestOptions reqOptions)
创建部门，本接口用于用于在企业通讯录中创建新部门，支持设置部门名称、父部门、负责人等信息。
|
DeleteDepartmentResp |
delete(DeleteDepartmentReq req)
删除部门，本接口用于删除部门。
|
DeleteDepartmentResp |
delete(DeleteDepartmentReq req,
RequestOptions reqOptions)
删除部门，本接口用于删除部门。
|
FilterDepartmentResp |
filter(FilterDepartmentReq req)
获取部门列表，本接口用于依据指定条件，批量获取符合条件的部门详情列表。
|
FilterDepartmentResp |
filter(FilterDepartmentReq req,
RequestOptions reqOptions)
获取部门列表，本接口用于依据指定条件，批量获取符合条件的部门详情列表。
|
MgetDepartmentResp |
mget(MgetDepartmentReq req)
批量获取部门信息，该接口支持传入多个部门ID，返回每个部门的详细信息（如名称、负责人、子部门等）。
|
MgetDepartmentResp |
mget(MgetDepartmentReq req,
RequestOptions reqOptions)
批量获取部门信息，该接口支持传入多个部门ID，返回每个部门的详细信息（如名称、负责人、子部门等）。
|
PatchDepartmentResp |
patch(PatchDepartmentReq req)
更新部门，本接口用于更新部门信息。
|
PatchDepartmentResp |
patch(PatchDepartmentReq req,
RequestOptions reqOptions)
更新部门，本接口用于更新部门信息。
|
SearchDepartmentResp |
search(SearchDepartmentReq req)
搜索部门，本接口用于搜索部门信息，通过部门名称等关键词搜索部门信息，返回符合条件的部门列表。
|
SearchDepartmentResp |
search(SearchDepartmentReq req,
RequestOptions reqOptions)
搜索部门，本接口用于搜索部门信息，通过部门名称等关键词搜索部门信息，返回符合条件的部门列表。
|
public Department(Config config)
public CreateDepartmentResp create(CreateDepartmentReq req, RequestOptions reqOptions) throws Exception
注意：;- 只能在当前应用的通讯录授权范围内的部门下创建部门，如果要在根部门下创建子部门，必须拥有全员权限。可以在 开发者后台-应用详情-权限管理中 查看通讯录授权范围。;- 本接口中支持的user_access_token 默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可创建部门时，管理员管理范围取最大集。管理员权限可查看帮助中心文档：[管理员创建管理员角色及分配权限](https://www.feishu.cn/hc/zh-CN/articles/360043495213-%E7%AE%A1%E7%90%86%E5%91%98%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%92%E8%89%B2%E5%8F%8A%E5%88%86%E9%85%8D%E6%9D%83%E9%99%90#tabs0|lineguid-dU31C);- 拥有本接口权限后，即可写入部门信息。但创建部门后仅返回应用有权限的字段数据，如果需要指定字段请按照文档中的描述申请对应权限。;- 本接口仅对自建应用开放。 ;
Exceptionpublic CreateDepartmentResp create(CreateDepartmentReq req) throws Exception
注意：;- 只能在当前应用的通讯录授权范围内的部门下创建部门，如果要在根部门下创建子部门，必须拥有全员权限。可以在 开发者后台-应用详情-权限管理中 查看通讯录授权范围。;- 本接口中支持的user_access_token 默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可创建部门时，管理员管理范围取最大集。管理员权限可查看帮助中心文档：[管理员创建管理员角色及分配权限](https://www.feishu.cn/hc/zh-CN/articles/360043495213-%E7%AE%A1%E7%90%86%E5%91%98%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%92%E8%89%B2%E5%8F%8A%E5%88%86%E9%85%8D%E6%9D%83%E9%99%90#tabs0|lineguid-dU31C);- 拥有本接口权限后，即可写入部门信息。但创建部门后仅返回应用有权限的字段数据，如果需要指定字段请按照文档中的描述申请对应权限。;- 本接口仅对自建应用开放。 ;
Exceptionpublic DeleteDepartmentResp delete(DeleteDepartmentReq req, RequestOptions reqOptions) throws Exception
注意：;- 删除部门需要有待删除部门及其父部门的应用数据权限[配置应用数据权限](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/configure-app-data-permissions) ;
Exceptionpublic DeleteDepartmentResp delete(DeleteDepartmentReq req) throws Exception
注意：;- 删除部门需要有待删除部门及其父部门的应用数据权限[配置应用数据权限](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/configure-app-data-permissions) ;
Exceptionpublic FilterDepartmentResp filter(FilterDepartmentReq req, RequestOptions reqOptions) throws Exception
注意：;- 本接口支持tenant_access_token和user_access_token。; - 使用tenant_access_token时，数据权限遵循应用的通讯录权限范围，返回的字段数据为应用有权限的字段。可以在开发者后台-应用详情-权限管理中查看通讯录授权范围。; - 使用user_access_token时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可查看部门信息时，管理员管理范围取最大集。管理员权限可查看帮助中心文档： [管理员创建管理员角色及分配权限](https://www.feishu.cn/hc/zh-CN/articles/360043495213-%E7%AE%A1%E7%90%86%E5%91%98%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%92%E8%89%B2%E5%8F%8A%E5%88%86%E9%85%8D%E6%9D%83%E9%99%90#tabs0|lineguid-dU31C) ;
Exceptionpublic FilterDepartmentResp filter(FilterDepartmentReq req) throws Exception
注意：;- 本接口支持tenant_access_token和user_access_token。; - 使用tenant_access_token时，数据权限遵循应用的通讯录权限范围，返回的字段数据为应用有权限的字段。可以在开发者后台-应用详情-权限管理中查看通讯录授权范围。; - 使用user_access_token时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可查看部门信息时，管理员管理范围取最大集。管理员权限可查看帮助中心文档： [管理员创建管理员角色及分配权限](https://www.feishu.cn/hc/zh-CN/articles/360043495213-%E7%AE%A1%E7%90%86%E5%91%98%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%92%E8%89%B2%E5%8F%8A%E5%88%86%E9%85%8D%E6%9D%83%E9%99%90#tabs0|lineguid-dU31C) ;
Exceptionpublic MgetDepartmentResp mget(MgetDepartmentReq req, RequestOptions reqOptions) throws Exception
**注意**：;- 本接口支持tenant_access_token和user_access_token。; - 使用tenant_access_token时，数据权限遵循应用的通讯录权限范围，返回的字段数据为应用有权限的字段。可通过[获取应用通讯录权限范围配置](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/contacts_range_configuration)确定应用的通讯录权限范围。; - 使用user_access_token时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可查看部门信息时，管理员管理范围取最大集。管理员权限可查看帮助中心文档： [管理员创建管理员角色及分配权限](https://www.feishu.cn/hc/zh-CN/articles/360043495213-%E7%AE%A1%E7%90%86%E5%91%98%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%92%E8%89%B2%E5%8F%8A%E5%88%86%E9%85%8D%E6%9D%83%E9%99%90#tabs0|lineguid-dU31C);- 为增强飞书组织架构 OpenAPI 的灵活性，于 **2024 年 10 月 21 日**对该 API 接口做出了更新升级，升级内容包括：优化查询已删除部门信息的返回数据结构。; - 升级前，查询已删除部门的信息时，不会返回部门负责人信息；升级后，查询已删除部门的信息时，返回数据中将包括部门负责人信息。 ;
Exceptionpublic MgetDepartmentResp mget(MgetDepartmentReq req) throws Exception
**注意**：;- 本接口支持tenant_access_token和user_access_token。; - 使用tenant_access_token时，数据权限遵循应用的通讯录权限范围，返回的字段数据为应用有权限的字段。可通过[获取应用通讯录权限范围配置](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/contacts_range_configuration)确定应用的通讯录权限范围。; - 使用user_access_token时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可查看部门信息时，管理员管理范围取最大集。管理员权限可查看帮助中心文档： [管理员创建管理员角色及分配权限](https://www.feishu.cn/hc/zh-CN/articles/360043495213-%E7%AE%A1%E7%90%86%E5%91%98%E5%88%9B%E5%BB%BA%E7%AE%A1%E7%90%86%E5%91%98%E8%A7%92%E8%89%B2%E5%8F%8A%E5%88%86%E9%85%8D%E6%9D%83%E9%99%90#tabs0|lineguid-dU31C);- 为增强飞书组织架构 OpenAPI 的灵活性，于 **2024 年 10 月 21 日**对该 API 接口做出了更新升级，升级内容包括：优化查询已删除部门信息的返回数据结构。; - 升级前，查询已删除部门的信息时，不会返回部门负责人信息；升级后，查询已删除部门的信息时，返回数据中将包括部门负责人信息。 ;
Exceptionpublic PatchDepartmentResp patch(PatchDepartmentReq req, RequestOptions reqOptions) throws Exception
Exceptionpublic PatchDepartmentResp patch(PatchDepartmentReq req) throws Exception
Exceptionpublic SearchDepartmentResp search(SearchDepartmentReq req, RequestOptions reqOptions) throws Exception
注意：;- 本接口支持tenant_access_token和user_access_token。; - 使用tenant_access_token时，数据权限遵循应用的通讯录权限范围，返回的字段数据为应用有权限的字段。**考虑到数据安全仅返回最多前100条匹配项**，若需精准结果需要更准确的输入。; - 使用user_access_token时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可查看员工信息时，管理员管理范围取最大集。 ;
Exceptionpublic SearchDepartmentResp search(SearchDepartmentReq req) throws Exception
注意：;- 本接口支持tenant_access_token和user_access_token。; - 使用tenant_access_token时，数据权限遵循应用的通讯录权限范围，返回的字段数据为应用有权限的字段。**考虑到数据安全仅返回最多前100条匹配项**，若需精准结果需要更准确的输入。; - 使用user_access_token时，默认为管理员用户，将校验管理员管理范围。当用户有多个管理员身份均可查看员工信息时，管理员管理范围取最大集。 ;
ExceptionCopyright © 2026. All rights reserved.