类 User
-
构造器概要
构造器 -
方法概要
修饰符和类型方法说明batch(BatchUserReq req) ,batch(BatchUserReq req, RequestOptions reqOptions) ,通过手机号或邮箱获取用户 ID,通过该接口,可使用手机号/邮箱获取用户的 ID 信息,具体获取支持的 ID 类型包括 open_id、user_id、union_id,可通过查询参数指定。batchGetId(BatchGetIdUserReq req, RequestOptions reqOptions) 通过手机号或邮箱获取用户 ID,通过该接口,可使用手机号/邮箱获取用户的 ID 信息,具体获取支持的 ID 类型包括 open_id、user_id、union_id,可通过查询参数指定。create(CreateUserReq req) 创建用户,使用该接口向通讯录创建一个用户,可以理解为员工入职。create(CreateUserReq req, RequestOptions reqOptions) 创建用户,使用该接口向通讯录创建一个用户,可以理解为员工入职。delete(DeleteUserReq req) 删除用户,该接口用于从通讯录删除一个用户信息,可以理解为员工离职。delete(DeleteUserReq req, RequestOptions reqOptions) 删除用户,该接口用于从通讯录删除一个用户信息,可以理解为员工离职。获取部门直属用户列表,基于部门ID获取部门直属用户列表。findByDepartment(FindByDepartmentUserReq req, RequestOptions reqOptions) 获取部门直属用户列表,基于部门ID获取部门直属用户列表。get(GetUserReq req) 获取单个用户信息,该接口用于获取通讯录中单个用户的信息。get(GetUserReq req, RequestOptions reqOptions) 获取单个用户信息,该接口用于获取通讯录中单个用户的信息。list(ListUserReq req) ,list(ListUserReq req, RequestOptions reqOptions) ,patch(PatchUserReq req) 修改用户部分信息,该接口用于更新通讯录中用户的字段,未传递的参数不会更新。patch(PatchUserReq req, RequestOptions reqOptions) 修改用户部分信息,该接口用于更新通讯录中用户的字段,未传递的参数不会更新。恢复已删除用户,该接口用于恢复已删除用户(已离职的成员),仅自建应用可申请,应用商店应用无权调用接口。resurrect(ResurrectUserReq req, RequestOptions reqOptions) 恢复已删除用户,该接口用于恢复已删除用户(已离职的成员),仅自建应用可申请,应用商店应用无权调用接口。update(UpdateUserReq req) 更新用户所有信息,该接口用于更新通讯录中用户的字段。update(UpdateUserReq req, RequestOptions reqOptions) 更新用户所有信息,该接口用于更新通讯录中用户的字段。,updateUserId(UpdateUserIdUserReq req, RequestOptions reqOptions) ,
-
构造器详细资料
-
User
-
-
方法详细资料
-
batch
,- 抛出:
Exception
-
batch
,- 抛出:
Exception
-
batchGetId
public BatchGetIdUserResp batchGetId(BatchGetIdUserReq req, RequestOptions reqOptions) throws Exception 通过手机号或邮箱获取用户 ID,通过该接口,可使用手机号/邮箱获取用户的 ID 信息,具体获取支持的 ID 类型包括 open_id、user_id、union_id,可通过查询参数指定。如果查询的手机号、邮箱不存在,或者无权限查看对应的用户,则返回的用户ID列表为空。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id ;
- 抛出:
Exception
-
batchGetId
通过手机号或邮箱获取用户 ID,通过该接口,可使用手机号/邮箱获取用户的 ID 信息,具体获取支持的 ID 类型包括 open_id、user_id、union_id,可通过查询参数指定。如果查询的手机号、邮箱不存在,或者无权限查看对应的用户,则返回的用户ID列表为空。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/batch_get_id ;
- 抛出:
Exception
-
create
创建用户,使用该接口向通讯录创建一个用户,可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。- 新增用户的所有部门必须都在当前应用的通讯录授权范围内才允许新增用户,如果想要在根部门下新增用户,必须要有全员权限。;- 应用商店应用无权限调用此接口。;- 创建用户后,会给用户发送邀请短信/邮件,用户在操作同意后才可访问团队。;- 返回数据中不返回手机号,如果需要请重新查询用户信息获取手机号。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create ;
- 抛出:
Exception
-
create
创建用户,使用该接口向通讯录创建一个用户,可以理解为员工入职。创建用户后只返回有数据权限的数据。具体的数据权限的与字段的对应关系请参照[应用权限](https://open.feishu.cn/document/ukTMukTMukTM/uQjN3QjL0YzN04CN2cDN)。- 新增用户的所有部门必须都在当前应用的通讯录授权范围内才允许新增用户,如果想要在根部门下新增用户,必须要有全员权限。;- 应用商店应用无权限调用此接口。;- 创建用户后,会给用户发送邀请短信/邮件,用户在操作同意后才可访问团队。;- 返回数据中不返回手机号,如果需要请重新查询用户信息获取手机号。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/create ;
- 抛出:
Exception
-
delete
删除用户,该接口用于从通讯录删除一个用户信息,可以理解为员工离职。- 若用户归属部门A、部门B,应用的通讯录权限范围必须包括部门A和部门B才可以删除用户。;- 用户可以在删除员工时设置删除员工数据(如文档)的接收者,如果不设置则由其leader接收,如果该员工没有leader,则会将该员工的数据删除。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/delete ;
- 抛出:
Exception
-
delete
删除用户,该接口用于从通讯录删除一个用户信息,可以理解为员工离职。- 若用户归属部门A、部门B,应用的通讯录权限范围必须包括部门A和部门B才可以删除用户。;- 用户可以在删除员工时设置删除员工数据(如文档)的接收者,如果不设置则由其leader接收,如果该员工没有leader,则会将该员工的数据删除。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/delete ;
- 抛出:
Exception
-
findByDepartment
public FindByDepartmentUserResp findByDepartment(FindByDepartmentUserReq req, RequestOptions reqOptions) throws Exception 获取部门直属用户列表,基于部门ID获取部门直属用户列表。- 部门ID 必填,根部门的部门ID为0。;- 使用 `user_access_token` 情况下根据个人组织架构的通讯录可见范围进行权限过滤,返回个人组织架构通讯录范围([登录企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility))内可见的用户数据。;- 使用`tenant_access_token`会根据应用通讯录的范围进行权限过滤。 如果请求的部门ID为0,则校验应用是否具有全员通讯录权限; 如果是非0的部门ID,则会验证应用是否具有该部门的通讯录权限。 无权限返回无权限错误码,有权限则返回对应部门下的直接用户列表。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/find_by_department ;
- 抛出:
Exception
-
findByDepartment
获取部门直属用户列表,基于部门ID获取部门直属用户列表。- 部门ID 必填,根部门的部门ID为0。;- 使用 `user_access_token` 情况下根据个人组织架构的通讯录可见范围进行权限过滤,返回个人组织架构通讯录范围([登录企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility))内可见的用户数据。;- 使用`tenant_access_token`会根据应用通讯录的范围进行权限过滤。 如果请求的部门ID为0,则校验应用是否具有全员通讯录权限; 如果是非0的部门ID,则会验证应用是否具有该部门的通讯录权限。 无权限返回无权限错误码,有权限则返回对应部门下的直接用户列表。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/find_by_department ;
- 抛出:
Exception
-
get
获取单个用户信息,该接口用于获取通讯录中单个用户的信息。官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get ;
- 抛出:
Exception
-
get
获取单个用户信息,该接口用于获取通讯录中单个用户的信息。官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/get ;
- 抛出:
Exception
-
list
,- 抛出:
Exception
-
list
,- 抛出:
Exception
-
patch
修改用户部分信息,该接口用于更新通讯录中用户的字段,未传递的参数不会更新。官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/patch ;
- 抛出:
Exception
-
patch
修改用户部分信息,该接口用于更新通讯录中用户的字段,未传递的参数不会更新。官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/patch ;
- 抛出:
Exception
-
resurrect
public ResurrectUserResp resurrect(ResurrectUserReq req, RequestOptions reqOptions) throws Exception 恢复已删除用户,该接口用于恢复已删除用户(已离职的成员),仅自建应用可申请,应用商店应用无权调用接口。- 仅支持恢复离职 30 天内的成员。恢复后,部分用户数据仍不可恢复,请谨慎调用。;- 待恢复成员的用户 ID 不能被企业内其他成员使用。如有重复,请先离职对应的成员,否则接口会报错。;- 待恢复成员的手机号和邮箱不能被企业内其他成员使用。如有重复,请先修改对应成员的信息,否则接口会报错。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/resurrect ;
- 抛出:
Exception
-
resurrect
恢复已删除用户,该接口用于恢复已删除用户(已离职的成员),仅自建应用可申请,应用商店应用无权调用接口。- 仅支持恢复离职 30 天内的成员。恢复后,部分用户数据仍不可恢复,请谨慎调用。;- 待恢复成员的用户 ID 不能被企业内其他成员使用。如有重复,请先离职对应的成员,否则接口会报错。;- 待恢复成员的手机号和邮箱不能被企业内其他成员使用。如有重复,请先修改对应成员的信息,否则接口会报错。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/resurrect ;
- 抛出:
Exception
-
update
更新用户所有信息,该接口用于更新通讯录中用户的字段。应用需要拥有待更新用户的通讯录授权,如果涉及到用户部门变更,还需要同时拥有变更前、后所有新部门的通讯录授权。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/update ;
- 抛出:
Exception
-
update
更新用户所有信息,该接口用于更新通讯录中用户的字段。应用需要拥有待更新用户的通讯录授权,如果涉及到用户部门变更,还需要同时拥有变更前、后所有新部门的通讯录授权。 ;
官网API文档链接:https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/update ;
- 抛出:
Exception
-
updateUserId
public UpdateUserIdUserResp updateUserId(UpdateUserIdUserReq req, RequestOptions reqOptions) throws Exception ,- 抛出:
Exception
-
updateUserId
,- 抛出:
Exception
-