@larksuiteoapi/node-sdk 1.4.1 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/es/index.js CHANGED
@@ -561,7 +561,7 @@ class Client$1 {
561
561
  },
562
562
  };
563
563
  /**
564
- * 管理后台-企业勋章
564
+ * 管理后台-数据报表
565
565
  */
566
566
  this.admin = {
567
567
  /**
@@ -1012,6 +1012,83 @@ class Client$1 {
1012
1012
  * 应用信息
1013
1013
  */
1014
1014
  this.application = {
1015
+ /**
1016
+ * 推荐规则
1017
+ */
1018
+ appRecommendRule: {
1019
+ listWithIterator: (payload, options) => __awaiter(this, void 0, void 0, function* () {
1020
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
1021
+ const sendRequest = (innerPayload) => __awaiter(this, void 0, void 0, function* () {
1022
+ const res = yield httpInstance
1023
+ .request({
1024
+ url: fillApiPath(`${this.domain}/open-apis/application/v6/app_recommend_rules`, path),
1025
+ method: "GET",
1026
+ headers: pickBy(innerPayload.headers, identity),
1027
+ params: pickBy(innerPayload.params, identity),
1028
+ })
1029
+ .catch((e) => {
1030
+ this.logger.error(formatErrors(e));
1031
+ });
1032
+ return res;
1033
+ });
1034
+ const Iterable = {
1035
+ [Symbol.asyncIterator]() {
1036
+ return __asyncGenerator(this, arguments, function* _a() {
1037
+ let hasMore = true;
1038
+ let pageToken;
1039
+ while (hasMore) {
1040
+ try {
1041
+ const res = yield __await(sendRequest({
1042
+ headers,
1043
+ params: Object.assign(Object.assign({}, params), { page_token: pageToken }),
1044
+ data,
1045
+ }));
1046
+ const _b = get(res, "data") || {}, {
1047
+ // @ts-ignore
1048
+ has_more,
1049
+ // @ts-ignore
1050
+ page_token,
1051
+ // @ts-ignore
1052
+ next_page_token } = _b, rest = __rest(_b, ["has_more", "page_token", "next_page_token"]);
1053
+ yield yield __await(rest);
1054
+ hasMore = Boolean(has_more);
1055
+ pageToken = page_token || next_page_token;
1056
+ }
1057
+ catch (e) {
1058
+ yield yield __await(null);
1059
+ break;
1060
+ }
1061
+ }
1062
+ });
1063
+ },
1064
+ };
1065
+ return Iterable;
1066
+ }),
1067
+ /**
1068
+ * {@link https://open.feishu.cn/api-explorer?project=application&resource=app_recommend_rule&apiName=list&version=v6 click to debug }
1069
+ *
1070
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/app_recommend_rule/list document }
1071
+ *
1072
+ * 获取当前设置的推荐规则列表
1073
+ *
1074
+ * 获取当前设置的推荐规则列表。
1075
+ */
1076
+ list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
1077
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
1078
+ return httpInstance
1079
+ .request({
1080
+ url: fillApiPath(`${this.domain}/open-apis/application/v6/app_recommend_rules`, path),
1081
+ method: "GET",
1082
+ data,
1083
+ params,
1084
+ headers,
1085
+ })
1086
+ .catch((e) => {
1087
+ this.logger.error(formatErrors(e));
1088
+ throw e;
1089
+ });
1090
+ }),
1091
+ },
1015
1092
  /**
1016
1093
  * 应用使用情况
1017
1094
  */
@@ -1862,7 +1939,7 @@ class Client$1 {
1862
1939
  *
1863
1940
  * 批量获取审批实例ID
1864
1941
  *
1865
- * 根据 approval_code 批量获取审批实例的 instance_code,用于拉取租户下某个审批定义的全部审批实例。默认以审批创建时间排序
1942
+ * 根据 approval_code 批量获取审批实例的 instance_code,用于拉取租户下某个审批定义的全部审批实例。默认以审批创建时间先后顺序排列
1866
1943
  */
1867
1944
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
1868
1945
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -2170,7 +2247,7 @@ class Client$1 {
2170
2247
  }),
2171
2248
  },
2172
2249
  /**
2173
- * 审批查询
2250
+ * 原生审批任务
2174
2251
  */
2175
2252
  task: {
2176
2253
  /**
@@ -2836,7 +2913,7 @@ class Client$1 {
2836
2913
  *
2837
2914
  * 由于部分企业使用的是自己的审批系统,而不是飞书审批系统,因此员工的请假、加班等数据无法流入到飞书考勤系统中,导致员工在请假时间段内依然收到打卡提醒,并且被记为缺卡。;;对于这些只使用飞书考勤系统,而未使用飞书审批系统的企业,可以通过考勤开放接口的形式,将三方审批结果数据回写到飞书考勤系统中。
2838
2915
  *
2839
- * 目前支持写入加班、请假、出差和外出这四种审批结果,写入只会追加(insert),不会覆盖(update)
2916
+ * 目前支持写入加班、请假、出差和外出这四种审批结果,写入只会追加(insert),不会覆盖(update)(开放接口导入的加班假期记录,在管理后台的假期加班里查不到,只能通过[获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query)来查询)
2840
2917
  */
2841
2918
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
2842
2919
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -3457,6 +3534,30 @@ class Client$1 {
3457
3534
  throw e;
3458
3535
  });
3459
3536
  }),
3537
+ /**
3538
+ * {@link https://open.feishu.cn/api-explorer?project=baike&resource=entity&apiName=extract&version=v1 click to debug }
3539
+ *
3540
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/extract document }
3541
+ *
3542
+ * 提取潜在的百科词条
3543
+ *
3544
+ * 提取文本中可能成为百科词条的词语,且不会过滤已经成为百科词条的词语。同时,会返回推荐的别名。
3545
+ */
3546
+ extract: (payload, options) => __awaiter(this, void 0, void 0, function* () {
3547
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
3548
+ return httpInstance
3549
+ .request({
3550
+ url: fillApiPath(`${this.domain}/open-apis/baike/v1/entities/extract`, path),
3551
+ method: "POST",
3552
+ data,
3553
+ params,
3554
+ headers,
3555
+ })
3556
+ .catch((e) => {
3557
+ this.logger.error(formatErrors(e));
3558
+ throw e;
3559
+ });
3560
+ }),
3460
3561
  /**
3461
3562
  * {@link https://open.feishu.cn/api-explorer?project=baike&resource=entity&apiName=get&version=v1 click to debug }
3462
3563
  *
@@ -6035,7 +6136,7 @@ class Client$1 {
6035
6136
  *
6036
6137
  * 该接口用于以当前身份(应用 / 用户)获取日历下的日程列表。;身份由 Header Authorization 的 Token 类型决定。
6037
6138
  *
6038
- * - 当前身份必须对日历有reader、writer或owner权限才会返回日程详细信息(调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口,role字段可查看权限)。;;- 仅支持primary、shared和resource类型的日历获取日程列表。;;- 调用时首先使用 page_token 分页拉取存量数据,之后使用 sync_token 增量同步变更数据。;;- 为了确保调用方日程同步数据的一致性,在使用sync_token时,不能同时使用start_time和end_time,否则可能造成日程数据缺失。
6139
+ * - 当前身份必须对日历有reader、writer或owner权限才会返回日程详细信息(调用[获取日历](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/calendar-v4/calendar/get)接口,role字段可查看权限)。;;- 仅支持primary、shared和resource类型的日历获取日程列表。;;- page_token 分页拉取存量数据,sync_token 增量同步变更数据;目前仅传anchor_time时,会返回page_token。;;- 为了确保调用方日程同步数据的一致性,在使用sync_token时,不能同时使用start_time和end_time,否则可能造成日程数据缺失。
6039
6140
  */
6040
6141
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
6041
6142
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -6694,13 +6795,7 @@ class Client$1 {
6694
6795
  /**
6695
6796
  * {@link https://open.feishu.cn/api-explorer?project=contact&resource=department&apiName=list&version=v3 click to debug }
6696
6797
  *
6697
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/list document }
6698
- *
6699
- * 获取部门信息列表
6700
- *
6701
- * 该接口用于获取当前部门子部门列表。[常见问题答疑](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN)。
6702
- *
6703
- * - 使用 user_access_token 时,返回该用户组织架构可见性范围([登陆企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility))内的所有可见部门。当进行递归查询时,只筛查最多1000个部门的可见性。;;- 使用 ; tenant_access_token 则基于应用的通讯录权限范围进行权限校验与过滤。由于 ; parent_department_id 是非必填参数,填与不填存在<b>两种数据权限校验与返回</b>情况:;<br> <br>1、请求设置了 ; parent_department_id 为A(根部门0),会检验A是否在通讯录权限内,若在( parent_department_id=0 时会校验是否为全员权限),则返回部门下子部门列表(根据fetch_child决定是否递归),否则返回无部门通讯录权限错误码。;<br> <br>2、请求未带 ; parent_department_id 参数,如通讯录范围为全员权限,只返回根部门ID(部门ID为0),否则返回根据通讯录范围配置的部门ID及子部门(根据 ; fetch_child 决定是否递归)。
6798
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=department&version=v3 document }
6704
6799
  */
6705
6800
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
6706
6801
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -7922,13 +8017,7 @@ class Client$1 {
7922
8017
  /**
7923
8018
  * {@link https://open.feishu.cn/api-explorer?project=contact&resource=user&apiName=list&version=v3 click to debug }
7924
8019
  *
7925
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/list document }
7926
- *
7927
- * 获取用户列表
7928
- *
7929
- * 基于部门ID获取部门下直属用户列表。;[常见问题答疑](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN)。
7930
- *
7931
- * - 使用 user_access_token 情况下根据个人组织架构的通讯录可见范围进行权限过滤,返回个人组织架构通讯录范围([登陆企业管理后台进行权限配置](https://www.feishu.cn/admin/security/permission/visibility))内可见的用户数据。;- tenant_access_token 基于应用通讯录范围进行权限鉴定。由于 department_id 是非必填参数,填与不填存在<b>两种数据权限校验与返回</b>情况:<br>1、请求设置了 department_id ;(根部门为0),会检验所带部门ID是否具有通讯录权限(如果带上 ; department_id=0 会校验是否有全员权限),有则返回部门下直属的成员列表, 否则提示无部门权限的错误码返回。<br>2、请求未带 ; department_id 参数,则会返回权限范围内的独立用户(权限范围直接包含了某用户,则该用户视为权限范围内的独立用户)。
8020
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=user&version=v3 document }
7932
8021
  */
7933
8022
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
7934
8023
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8424,7 +8513,7 @@ class Client$1 {
8424
8513
  *
8425
8514
  * 创建导出任务
8426
8515
  *
8427
- * 创建导出任务,将云文档导出为文件
8516
+ * 创建导出任务,将云文件导出为指定格式的本地文件。该接口为异步接口,需要通过轮询 [查询导出任务结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/get) 接口获取任务结果。
8428
8517
  */
8429
8518
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8430
8519
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8487,7 +8576,7 @@ class Client$1 {
8487
8576
  *
8488
8577
  * 查询导出任务结果
8489
8578
  *
8490
- * 根据创建导出任务的ticket查询导出任务的结果
8579
+ * 根据[创建导出任务](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create)的ticket查询导出任务的结果,前提条件需要先调用创建导出任务接口。;;通过该接口获取到下载文件的 token 后调用[下载导出文件接口](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/download)将文件进行下载
8491
8580
  */
8492
8581
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8493
8582
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8610,9 +8699,9 @@ class Client$1 {
8610
8699
  *
8611
8700
  * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/list document }
8612
8701
  *
8613
- * 获取文档评论
8702
+ * 分页获取文档评论
8614
8703
  *
8615
- * 根据文档token分页获取云文档中的评论。
8704
+ * 该接口用于根据文档 token 分页获取文档评论。
8616
8705
  */
8617
8706
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8618
8707
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -11453,7 +11542,7 @@ class Client$1 {
11453
11542
  /**
11454
11543
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=create&version=v1 click to debug }
11455
11544
  *
11456
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/create_application document }
11545
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/create document }
11457
11546
  *
11458
11547
  * 创建投递
11459
11548
  *
@@ -11477,7 +11566,7 @@ class Client$1 {
11477
11566
  /**
11478
11567
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=get&version=v1 click to debug }
11479
11568
  *
11480
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/get-application document }
11569
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get document }
11481
11570
  *
11482
11571
  * 获取投递信息
11483
11572
  *
@@ -11501,7 +11590,7 @@ class Client$1 {
11501
11590
  /**
11502
11591
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=list&version=v1 click to debug }
11503
11592
  *
11504
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/get-application-list document }
11593
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list document }
11505
11594
  *
11506
11595
  * 获取投递列表
11507
11596
  *
@@ -11525,7 +11614,7 @@ class Client$1 {
11525
11614
  /**
11526
11615
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=offer&version=v1 click to debug }
11527
11616
  *
11528
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/get-application-offer document }
11617
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/offer document }
11529
11618
  *
11530
11619
  * 获取 Offer 信息
11531
11620
  *
@@ -11549,7 +11638,7 @@ class Client$1 {
11549
11638
  /**
11550
11639
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=terminate&version=v1 click to debug }
11551
11640
  *
11552
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/terminate-application document }
11641
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/terminate document }
11553
11642
  *
11554
11643
  * 终止投递
11555
11644
  *
@@ -11573,7 +11662,7 @@ class Client$1 {
11573
11662
  /**
11574
11663
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=transfer_onboard&version=v1 click to debug }
11575
11664
  *
11576
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uczM1YjL3MTN24yNzUjN document }
11665
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/transfer_onboard document }
11577
11666
  *
11578
11667
  * 操作候选人入职
11579
11668
  *
@@ -11596,17 +11685,13 @@ class Client$1 {
11596
11685
  }),
11597
11686
  },
11598
11687
  /**
11599
- * 面试
11688
+ * application.interview
11600
11689
  */
11601
11690
  applicationInterview: {
11602
11691
  /**
11603
11692
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application.interview&apiName=list&version=v1 click to debug }
11604
11693
  *
11605
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application-interview/list document }
11606
- *
11607
- * 获取面试记录列表
11608
- *
11609
- * 根据投递 ID 获取面试记录列表
11694
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=hire&resource=application.interview&version=v1 document }
11610
11695
  */
11611
11696
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
11612
11697
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -11761,7 +11846,7 @@ class Client$1 {
11761
11846
  /**
11762
11847
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=job&apiName=get&version=v1 click to debug }
11763
11848
  *
11764
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/job/get-job document }
11849
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get document }
11765
11850
  *
11766
11851
  * 获取职位信息
11767
11852
  *
@@ -11819,7 +11904,7 @@ class Client$1 {
11819
11904
  /**
11820
11905
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=job_process&apiName=list&version=v1 click to debug }
11821
11906
  *
11822
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/jop-process/get-process document }
11907
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_process/list document }
11823
11908
  *
11824
11909
  * 获取招聘流程信息
11825
11910
  *
@@ -11943,17 +12028,13 @@ class Client$1 {
11943
12028
  }),
11944
12029
  },
11945
12030
  /**
11946
- * offer
12031
+ * offer_schema
11947
12032
  */
11948
12033
  offerSchema: {
11949
12034
  /**
11950
12035
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=offer_schema&apiName=get&version=v1 click to debug }
11951
12036
  *
11952
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_schema/get document }
11953
- *
11954
- * 获取 Offer 申请表详细信息
11955
- *
11956
- * 根据 Offer 申请表 ID,获取 Offer 申请表的详细信息
12037
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=hire&resource=offer_schema&version=v1 document }
11957
12038
  */
11958
12039
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
11959
12040
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12084,7 +12165,7 @@ class Client$1 {
12084
12165
  /**
12085
12166
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=talent&apiName=get&version=v1 click to debug }
12086
12167
  *
12087
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUzM1YjL1MTN24SNzUjN/get-talent document }
12168
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get document }
12088
12169
  *
12089
12170
  * 获取人才信息
12090
12171
  *
@@ -12243,7 +12324,7 @@ class Client$1 {
12243
12324
  *
12244
12325
  * 获取会话中的群公告信息,公告信息格式与[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。
12245
12326
  *
12246
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app)
12327
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 获取内部群信息时,操作者须与群组在同一租户下
12247
12328
  */
12248
12329
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12249
12330
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12269,7 +12350,7 @@ class Client$1 {
12269
12350
  *
12270
12351
  * 更新会话中的群公告信息,更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。
12271
12352
  *
12272
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置,群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置,所有成员可以更新群公告
12353
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 操作者需要拥有群公告文档的阅读权限;- 获取内部群信息时,操作者须与群组在同一租户下;- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置,群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置,所有成员可以更新群公告
12273
12354
  */
12274
12355
  patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12275
12356
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12326,7 +12407,7 @@ class Client$1 {
12326
12407
  *
12327
12408
  * 解散群组。
12328
12409
  *
12329
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 如果使用tenant_access_token,需要机器人符合以下任一情况才可解散群:; - 机器人是群主; - 机器人是群的创建者且具备==更新应用所创建群的群信息==权限;- 如果使用user_access_token,需要对应的用户是群主才可解散群;- 解散外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12410
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 如果使用tenant_access_token,需要机器人符合以下任一情况才可解散群:; - 机器人是群主; - 机器人是群的创建者且具备==更新应用所创建群的群信息==权限;- 如果使用user_access_token,需要对应的用户是群主才可解散群
12330
12411
  */
12331
12412
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12332
12413
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12352,7 +12433,7 @@ class Client$1 {
12352
12433
  *
12353
12434
  * 获取群名称、群描述、群头像、群主 ID 等群基本信息。
12354
12435
  *
12355
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群里(否则只会返回群名称、群头像等基本信息);- 获取内部群信息时,操作者须与群组在同一租户下;- 获取外部群信息时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12436
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群里(否则只会返回群名称、群头像等基本信息);- 获取内部群信息时,操作者须与群组在同一租户下
12356
12437
  */
12357
12438
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12358
12439
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12378,7 +12459,7 @@ class Client$1 {
12378
12459
  *
12379
12460
  * 获取指定群的分享链接
12380
12461
  *
12381
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 单聊、密聊、团队群不支持分享群链接;- 当Bot被停用或Bot退出群组时,Bot生成的群链接也将停用;- 当群聊开启了 ==仅群主和群管理员可添加群成员/分享群== 设置时,仅**群主**和**群管理员**可以获取群分享链接;- 获取内部群分享链接时,操作者须与群组在同一租户下;- 获取外部群分享链接时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12462
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 单聊、密聊、团队群不支持分享群链接;- 当Bot被停用或Bot退出群组时,Bot生成的群链接也将停用;- 当群聊开启了 ==仅群主和群管理员可添加群成员/分享群== 设置时,仅**群主**和**群管理员**可以获取群分享链接;- 获取内部群分享链接时,操作者须与群组在同一租户下
12382
12463
  */
12383
12464
  link: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12384
12465
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12452,7 +12533,7 @@ class Client$1 {
12452
12533
  *
12453
12534
  * 获取用户或者机器人所在群列表。
12454
12535
  *
12455
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 请注意区分本接口和[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)的请求 URL;- 获取的群列表不包含p2p单聊群
12536
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 请注意区分本接口和[获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)的请求 URL;- 获取的群列表不包含P2P单聊
12456
12537
  */
12457
12538
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12458
12539
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12552,7 +12633,7 @@ class Client$1 {
12552
12633
  *
12553
12634
  * 更新群头像、群名称、群描述、群配置、转让群主等。
12554
12635
  *
12555
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 对于群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新所有信息;- 对于不满足上述权限条件的群成员或机器人:; - 若未开启 ==仅群主和群管理员可编辑群信息== 配置,仅可更新群头像、群名称、群描述、群国际化名称信息; - 若开启了 ==仅群主和群管理员可编辑群信息== 配置,任何群信息都不能修改;- 更新外部群信息时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12636
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 对于群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新所有信息;- 对于不满足上述权限条件的群成员或机器人:; - 若未开启 ==仅群主和群管理员可编辑群信息== 配置,仅可更新群头像、群名称、群描述、群国际化名称信息; - 若开启了 ==仅群主和群管理员可编辑群信息== 配置,任何群信息都不能修改
12556
12637
  */
12557
12638
  update: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12558
12639
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12583,7 +12664,7 @@ class Client$1 {
12583
12664
  *
12584
12665
  * 将用户或机器人指定为群管理员。
12585
12666
  *
12586
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以指定群管理员;- 对于普通群,最多指定 10 个管理员;- 对于超大群,最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人;- 指定机器人类型的管理员请使用 ==app_id==
12667
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以指定群管理员
12587
12668
  */
12588
12669
  addManagers: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12589
12670
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12609,7 +12690,7 @@ class Client$1 {
12609
12690
  *
12610
12691
  * 删除指定的群管理员(用户或机器人)。
12611
12692
  *
12612
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以删除群管理员;- 每次请求最多指定 50 个用户或者 5 个机器人;- 删除机器人类型的管理员请使用 ==app_id==
12693
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以删除群管理员
12613
12694
  */
12614
12695
  deleteManagers: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12615
12696
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12640,7 +12721,7 @@ class Client$1 {
12640
12721
  *
12641
12722
  * 将用户或机器人拉入群聊。
12642
12723
  *
12643
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 如需拉用户进群,需要机器人对用户有[可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability); - 机器人或授权用户必须在群组中;- 外部租户不能被加入到内部群中;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限; - 在开启 ==仅群主和群管理员可添加群成员== 的设置时,仅有群主/管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可以拉用户或者机器人进群; - 在未开启 ==仅群主和群管理员可添加群成员== 的设置时,所有群成员都可以拉用户或机器人进群
12724
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 如需拉用户进群,需要机器人对用户有[可用性](https://open.feishu.cn/document/home/introduction-to-scope-and-authorization/availability); - 机器人或授权用户必须在群组中;- 外部租户不能被加入到内部群中;- 操作内部群时,操作者须与群组在同一租户下; - 在开启 ==仅群主和群管理员可添加群成员== 的设置时,仅有群主/管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可以拉用户或者机器人进群; - 在未开启 ==仅群主和群管理员可添加群成员== 的设置时,所有群成员都可以拉用户或机器人进群
12644
12725
  */
12645
12726
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12646
12727
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12666,7 +12747,7 @@ class Client$1 {
12666
12747
  *
12667
12748
  * 将用户或机器人移出群聊。
12668
12749
  *
12669
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 用户或机器人在任何条件下均可移除自己出群(即主动退群);- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人,可以移除其他用户或者机器人; - 每次请求,最多移除50个用户或者5个机器人
12750
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 用户或机器人在任何条件下均可移除自己出群(即主动退群);- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人,可以移除其他用户或者机器人;- 每次请求,最多移除50个用户或者5个机器人;- 操作内部群时,操作者须与群组在同一租户下
12670
12751
  */
12671
12752
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12672
12753
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12738,9 +12819,9 @@ class Client$1 {
12738
12819
  *
12739
12820
  * 获取群成员列表
12740
12821
  *
12741
- * 如果用户在群中,则返回该群的成员列表。
12822
+ * 获取用户/机器人所在群的群成员列表。
12742
12823
  *
12743
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员,因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员,会一次性返回,这会导致返回的群成员个数可能会大于指定的page_size
12824
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中; - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员,因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员,会一次性返回,这会导致返回的群成员个数可能会大于指定的page_size;- 获取内部群信息时,操作者须与群组在同一租户下
12744
12825
  */
12745
12826
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12746
12827
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12765,6 +12846,8 @@ class Client$1 {
12765
12846
  * 判断用户或机器人是否在群里
12766
12847
  *
12767
12848
  * 根据使用的access_token判断对应的用户或者机器人是否在群里。
12849
+ *
12850
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 获取内部群信息时,操作者须与群组在同一租户下
12768
12851
  */
12769
12852
  isInChat: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12770
12853
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12790,7 +12873,7 @@ class Client$1 {
12790
12873
  *
12791
12874
  * 用户或机器人主动加入群聊。
12792
12875
  *
12793
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 目前仅支持加入公开群
12876
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 目前仅支持加入公开群;- 操作内部群时,操作者须与群组在同一租户下
12794
12877
  */
12795
12878
  meJoin: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12796
12879
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12924,9 +13007,9 @@ class Client$1 {
12924
13007
  *
12925
13008
  * 添加会话标签页
12926
13009
  *
12927
- * 添加自定义会话标签页
13010
+ * 添加自定义会话标签页。
12928
13011
  *
12929
- * 注意事项:;;- 只允许添加类型为docurl的会话标签页;;- 创建时不需要设置tabID;;- 一个群内最多只允许添加20个自定义会话标签页;;- 会话标签页的名称不超过30个字符;;- 添加doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限
13012
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许添加类型为`doc`和`url`的会话标签页;- 添加doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限;- tab_config字段当前只对`url`类型的会话标签页生效;- 在开启 ==仅群主和管理员可管理标签页== 的设置时,仅群主和群管理员可以添加会话标签页;- 操作内部群时,操作者须与群组在同一租户下
12930
13013
  */
12931
13014
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12932
13015
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12950,7 +13033,9 @@ class Client$1 {
12950
13033
  *
12951
13034
  * 删除会话标签页
12952
13035
  *
12953
- * 删除会话标签页
13036
+ * 删除会话标签页。
13037
+ *
13038
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许删除类型为`doc`和`url`的会话标签页;- 在开启 ==仅群主和管理员可管理标签页== 的设置时,仅群主和群管理员可以删除会话标签页;- 操作内部群时,操作者须与群组在同一租户下
12954
13039
  */
12955
13040
  deleteTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12956
13041
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12974,7 +13059,9 @@ class Client$1 {
12974
13059
  *
12975
13060
  * 拉取会话标签页
12976
13061
  *
12977
- * 拉取会话标签页
13062
+ * 拉取会话标签页。
13063
+ *
13064
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 操作内部群时,操作者须与群组在同一租户下
12978
13065
  */
12979
13066
  listTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12980
13067
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12998,9 +13085,9 @@ class Client$1 {
12998
13085
  *
12999
13086
  * 会话标签页排序
13000
13087
  *
13001
- * 会话标签页排序
13088
+ * 会话标签页排序。
13002
13089
  *
13003
- * 注意事项:;;- 当前消息标签页固定为第一顺位,不参与排序,但是请求体中必须包含。;;- 请求体必须包含全部的TabID
13090
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 消息标签页强制固定为第一顺位,不参与排序,但是请求体中必须包含该标签页的Tab ID;- 操作内部群时,操作者须与群组在同一租户下
13004
13091
  */
13005
13092
  sortTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13006
13093
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13026,7 +13113,7 @@ class Client$1 {
13026
13113
  *
13027
13114
  * 更新会话标签页
13028
13115
  *
13029
- * 注意事项:;;- 只允许更新类型为docurl的会话标签页;;- 会话标签页的名称不超过30个字符;;- 更新doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限
13116
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许更新类型为`doc`和`url`的会话标签页;- 更新doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限;- 在开启 ==仅群主和管理员可管理标签页== 的设置时,仅群主和群管理员可以更新会话标签页;- 操作内部群时,操作者须与群组在同一租户下
13030
13117
  */
13031
13118
  updateTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13032
13119
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13057,7 +13144,7 @@ class Client$1 {
13057
13144
  *
13058
13145
  * 撤销会话中的置顶。
13059
13146
  *
13060
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 撤销内部群置顶时,操作者须与群组在同一租户下;- 撤销外部群置顶时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
13147
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 撤销内部群置顶时,操作者须与群组在同一租户下
13061
13148
  */
13062
13149
  deleteTopNotice: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13063
13150
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13083,7 +13170,7 @@ class Client$1 {
13083
13170
  *
13084
13171
  * 更新会话中的群置顶信息,可以将群中的某一条消息,或者群公告置顶显示。
13085
13172
  *
13086
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 更新内部群置顶时,操作者须与群组在同一租户下;- 更新外部群置顶时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
13173
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 更新内部群置顶时,操作者须与群组在同一租户下
13087
13174
  */
13088
13175
  putTopNotice: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13089
13176
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13248,7 +13335,7 @@ class Client$1 {
13248
13335
  }),
13249
13336
  },
13250
13337
  /**
13251
- * 消息 - 消息卡片
13338
+ * 消息加急
13252
13339
  */
13253
13340
  message: {
13254
13341
  /**
@@ -13380,7 +13467,7 @@ class Client$1 {
13380
13467
  /**
13381
13468
  * {@link https://open.feishu.cn/api-explorer?project=im&resource=message&apiName=list&version=v1 click to debug }
13382
13469
  *
13383
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uADO3YjLwgzN24CM4cjN document }
13470
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list document }
13384
13471
  *
13385
13472
  * 获取会话历史消息
13386
13473
  *
@@ -13388,7 +13475,7 @@ class Client$1 {
13388
13475
  *
13389
13476
  * - 需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app) ;- 获取消息时,机器人必须在群组中
13390
13477
  *
13391
- * 接口级别权限默认只能获取单聊(p2p)消息,如果需要获取群组(group)消息,应用还必须拥有 ***获取群组中所有消息*** 权限
13478
+ * 接口级别权限默认只能获取单聊(p2p)消息,如果需要获取群组(group)消息,应用还必须拥有 **==获取群组中所有消息==** 权限
13392
13479
  */
13393
13480
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13394
13481
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13414,7 +13501,7 @@ class Client$1 {
13414
13501
  *
13415
13502
  * 更新应用已发送的消息卡片内容。
13416
13503
  *
13417
- * 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 若以user_access_token更新消息,该操作用户必须是卡片消息的发送者;- 对所有人更新[「共享卡片」](ukTMukTMukTM/uAjNwUjLwYDM14CM2ATN),需在卡片的config属性中,显式声明`"update_multi":true`。 更新特定人的卡片内容,必须在用户对卡片进行交互操作后触发调用,参考[「独享卡片」](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN#49904b71) ;- 当前仅支持更新未撤回的 **卡片消息**;- **不支持更新批量消息**;- 文本消息请求体最大不能超过150KB;卡片及富文本消息请求体最大不能超过30KB;- 仅支持修改14天内发送的消息;- 单条消息更新频控为**5QPS**
13504
+ * 注意事项:;- 需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 若以user_access_token更新消息,该操作用户必须是卡片消息的发送者;- 仅支持对所有人更新**未撤回**的[「共享卡片」](ukTMukTMukTM/uAjNwUjLwYDM14CM2ATN)消息,需在卡片的config属性中,显式声明 =="update_multi":true==。 ;- **不支持更新批量消息**;- 文本消息请求体最大不能超过150KB;卡片及富文本消息请求体最大不能超过30KB;- 仅支持修改14天内发送的消息;- 单条消息更新频控为**5QPS**
13418
13505
  */
13419
13506
  patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13420
13507
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -15790,7 +15877,7 @@ class Client$1 {
15790
15877
  *
15791
15878
  * 创建表格
15792
15879
  *
15793
- * 使用该接口可以在指定的目录下创建在线表格。
15880
+ * 在指定目录下创建表格
15794
15881
  */
15795
15882
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
15796
15883
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16224,7 +16311,7 @@ class Client$1 {
16224
16311
  }),
16225
16312
  },
16226
16313
  /**
16227
- * 行列
16314
+ * 工作表
16228
16315
  */
16229
16316
  spreadsheetSheet: {
16230
16317
  /**
@@ -16234,7 +16321,7 @@ class Client$1 {
16234
16321
  *
16235
16322
  * 查找单元格
16236
16323
  *
16237
- * 按照指定的条件查找子表的某个范围内的数据符合条件的单元格位置。请求体中的 range 和 find 字段为必填。
16324
+ * 在指定范围内查找符合查找条件的单元格。
16238
16325
  */
16239
16326
  find: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16240
16327
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16615,7 +16702,7 @@ class Client$1 {
16615
16702
  *
16616
16703
  * 完成任务
16617
16704
  *
16618
- * 该接口用于将任务状态修改为”已完成“
16705
+ * 该接口用于将任务状态修改为“已完成”。;完成任务是指整个任务全部完成,而不支持执行者分别完成任务,执行成功后,任务对所有关联用户都变为完成状态。
16619
16706
  */
16620
16707
  complete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16621
16708
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16639,7 +16726,7 @@ class Client$1 {
16639
16726
  *
16640
16727
  * 创建任务
16641
16728
  *
16642
- * 该接口可以创建一个任务(基本信息),如果需要绑定协作者等需要调用别的资源管理接口。其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型,不传时默认返回 open_id。当使用tenant_access_token 调用接口时,如果user_id_type为user_id,则不会返回creator_id。
16729
+ * 该接口可以创建一个任务,支持填写任务的基本信息,包括任务的标题,描述及协作者等。;在此基础上,创建任务时可以设置截止时间和重复规则,将任务设置为定期执行的重复任务。通过添加协作者,则可以让其他用户协同完成该任务。;此外,接口也提供了一些支持自定义内容的字段,调用方可以实现定制化效果,如完成任务后跳转到指定结束界面。
16643
16730
  */
16644
16731
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16645
16732
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16836,7 +16923,7 @@ class Client$1 {
16836
16923
  *
16837
16924
  * 新增执行者
16838
16925
  *
16839
- * 该接口用于新增任务执行者,一次性可以添加多个执行者。新增的执行者必须是用户的ID。
16926
+ * 该接口用于新增任务执行者,一次性可以添加多个执行者。;只有任务的创建者和执行者才能添加执行者,关注人无权限添加。
16840
16927
  */
16841
16928
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16842
16929
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -17696,6 +17783,30 @@ class Client$1 {
17696
17783
  throw e;
17697
17784
  });
17698
17785
  }),
17786
+ /**
17787
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=export&apiName=resource_reservation_list&version=v1 click to debug }
17788
+ *
17789
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/resource_reservation_list document }
17790
+ *
17791
+ * 导出会议室预定数据
17792
+ *
17793
+ * 导出会议室预定数据,具体权限要求请参考「导出概述」
17794
+ */
17795
+ resourceReservationList: (payload, options) => __awaiter(this, void 0, void 0, function* () {
17796
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
17797
+ return httpInstance
17798
+ .request({
17799
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/exports/resource_reservation_list`, path),
17800
+ method: "POST",
17801
+ data,
17802
+ params,
17803
+ headers,
17804
+ })
17805
+ .catch((e) => {
17806
+ this.logger.error(formatErrors(e));
17807
+ throw e;
17808
+ });
17809
+ }),
17699
17810
  },
17700
17811
  /**
17701
17812
  * 会议
@@ -18204,7 +18315,7 @@ class Client$1 {
18204
18315
  }),
18205
18316
  },
18206
18317
  /**
18207
- * 会议室预定范围
18318
+ * reserve_config
18208
18319
  */
18209
18320
  reserveConfig: {
18210
18321
  /**
@@ -18257,25 +18368,71 @@ class Client$1 {
18257
18368
  }),
18258
18369
  },
18259
18370
  /**
18260
- * 会议室配置
18371
+ * 会议室
18261
18372
  */
18262
- roomConfig: {
18373
+ room: {
18263
18374
  /**
18264
- * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=query&version=v1 click to debug }
18375
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=create&version=v1 click to debug }
18265
18376
  *
18266
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_config/query document }
18377
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/create document }
18267
18378
  *
18268
- * 查询会议室配置
18379
+ * 创建会议室
18380
+ *
18381
+ * 该接口用于创建会议室
18382
+ */
18383
+ create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18384
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18385
+ return httpInstance
18386
+ .request({
18387
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms`, path),
18388
+ method: "POST",
18389
+ data,
18390
+ params,
18391
+ headers,
18392
+ })
18393
+ .catch((e) => {
18394
+ this.logger.error(formatErrors(e));
18395
+ throw e;
18396
+ });
18397
+ }),
18398
+ /**
18399
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=delete&version=v1 click to debug }
18400
+ *
18401
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/delete document }
18269
18402
  *
18270
- * 查询一个范围内的会议室配置。
18403
+ * 删除会议室
18271
18404
  *
18272
- * 根据查询范围传入对应的参数
18405
+ * 该接口可以用来删除某个会议室
18273
18406
  */
18274
- query: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18407
+ delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18275
18408
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
18276
18409
  return httpInstance
18277
18410
  .request({
18278
- url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/query`, path),
18411
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/:room_id`, path),
18412
+ method: "DELETE",
18413
+ data,
18414
+ params,
18415
+ headers,
18416
+ })
18417
+ .catch((e) => {
18418
+ this.logger.error(formatErrors(e));
18419
+ throw e;
18420
+ });
18421
+ }),
18422
+ /**
18423
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=get&version=v1 click to debug }
18424
+ *
18425
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/get document }
18426
+ *
18427
+ * 查询会议室详情
18428
+ *
18429
+ * 该接口可以使用会议室ID查询会议室详情
18430
+ */
18431
+ get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18432
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18433
+ return httpInstance
18434
+ .request({
18435
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/:room_id`, path),
18279
18436
  method: "GET",
18280
18437
  data,
18281
18438
  params,
@@ -18286,22 +18443,92 @@ class Client$1 {
18286
18443
  throw e;
18287
18444
  });
18288
18445
  }),
18446
+ listWithIterator: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18447
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18448
+ const sendRequest = (innerPayload) => __awaiter(this, void 0, void 0, function* () {
18449
+ const res = yield httpInstance
18450
+ .request({
18451
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms`, path),
18452
+ method: "GET",
18453
+ headers: pickBy(innerPayload.headers, identity),
18454
+ params: pickBy(innerPayload.params, identity),
18455
+ })
18456
+ .catch((e) => {
18457
+ this.logger.error(formatErrors(e));
18458
+ });
18459
+ return res;
18460
+ });
18461
+ const Iterable = {
18462
+ [Symbol.asyncIterator]() {
18463
+ return __asyncGenerator(this, arguments, function* _a() {
18464
+ let hasMore = true;
18465
+ let pageToken;
18466
+ while (hasMore) {
18467
+ try {
18468
+ const res = yield __await(sendRequest({
18469
+ headers,
18470
+ params: Object.assign(Object.assign({}, params), { page_token: pageToken }),
18471
+ data,
18472
+ }));
18473
+ const _b = get(res, "data") || {}, {
18474
+ // @ts-ignore
18475
+ has_more,
18476
+ // @ts-ignore
18477
+ page_token,
18478
+ // @ts-ignore
18479
+ next_page_token } = _b, rest = __rest(_b, ["has_more", "page_token", "next_page_token"]);
18480
+ yield yield __await(rest);
18481
+ hasMore = Boolean(has_more);
18482
+ pageToken = page_token || next_page_token;
18483
+ }
18484
+ catch (e) {
18485
+ yield yield __await(null);
18486
+ break;
18487
+ }
18488
+ }
18489
+ });
18490
+ },
18491
+ };
18492
+ return Iterable;
18493
+ }),
18289
18494
  /**
18290
- * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=set&version=v1 click to debug }
18495
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=list&version=v1 click to debug }
18291
18496
  *
18292
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_config/set document }
18497
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/list document }
18293
18498
  *
18294
- * 设置会议室配置
18499
+ * 查询会议室列表
18500
+ *
18501
+ * 该接口可以用来查询某个会议室层级下会议室列表
18502
+ */
18503
+ list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18504
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18505
+ return httpInstance
18506
+ .request({
18507
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms`, path),
18508
+ method: "GET",
18509
+ data,
18510
+ params,
18511
+ headers,
18512
+ })
18513
+ .catch((e) => {
18514
+ this.logger.error(formatErrors(e));
18515
+ throw e;
18516
+ });
18517
+ }),
18518
+ /**
18519
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=mget&version=v1 click to debug }
18295
18520
  *
18296
- * 设置一个范围内的会议室配置。
18521
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/mget document }
18297
18522
  *
18298
- * 根据设置范围传入对应的参数
18523
+ * 批量查询会议室详情
18524
+ *
18525
+ * 该接口可以使用会议室ID批量查询会议室详情
18299
18526
  */
18300
- set: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18527
+ mget: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18301
18528
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
18302
18529
  return httpInstance
18303
18530
  .request({
18304
- url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/set`, path),
18531
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/mget`, path),
18305
18532
  method: "POST",
18306
18533
  data,
18307
18534
  params,
@@ -18312,6 +18539,373 @@ class Client$1 {
18312
18539
  throw e;
18313
18540
  });
18314
18541
  }),
18542
+ /**
18543
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=patch&version=v1 click to debug }
18544
+ *
18545
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/patch document }
18546
+ *
18547
+ * 更新会议室
18548
+ *
18549
+ * 该接口可以用来更新某个会议室的信息
18550
+ */
18551
+ patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18552
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18553
+ return httpInstance
18554
+ .request({
18555
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/:room_id`, path),
18556
+ method: "PATCH",
18557
+ data,
18558
+ params,
18559
+ headers,
18560
+ })
18561
+ .catch((e) => {
18562
+ this.logger.error(formatErrors(e));
18563
+ throw e;
18564
+ });
18565
+ }),
18566
+ /**
18567
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=search&version=v1 click to debug }
18568
+ *
18569
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/search document }
18570
+ *
18571
+ * 搜索会议室
18572
+ *
18573
+ * 该接口可以用来搜索会议室,支持使用关键词进行搜索,也支持使用自定义会议室ID进行查询
18574
+ */
18575
+ search: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18576
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18577
+ return httpInstance
18578
+ .request({
18579
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/search`, path),
18580
+ method: "POST",
18581
+ data,
18582
+ params,
18583
+ headers,
18584
+ })
18585
+ .catch((e) => {
18586
+ this.logger.error(formatErrors(e));
18587
+ throw e;
18588
+ });
18589
+ }),
18590
+ },
18591
+ /**
18592
+ * room_config
18593
+ */
18594
+ roomConfig: {
18595
+ /**
18596
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=query&version=v1 click to debug }
18597
+ *
18598
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=vc&resource=room_config&version=v1 document }
18599
+ */
18600
+ query: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18601
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18602
+ return httpInstance
18603
+ .request({
18604
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/query`, path),
18605
+ method: "GET",
18606
+ data,
18607
+ params,
18608
+ headers,
18609
+ })
18610
+ .catch((e) => {
18611
+ this.logger.error(formatErrors(e));
18612
+ throw e;
18613
+ });
18614
+ }),
18615
+ /**
18616
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=set&version=v1 click to debug }
18617
+ *
18618
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=set&project=vc&resource=room_config&version=v1 document }
18619
+ */
18620
+ set: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18621
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18622
+ return httpInstance
18623
+ .request({
18624
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/set`, path),
18625
+ method: "POST",
18626
+ data,
18627
+ params,
18628
+ headers,
18629
+ })
18630
+ .catch((e) => {
18631
+ this.logger.error(formatErrors(e));
18632
+ throw e;
18633
+ });
18634
+ }),
18635
+ },
18636
+ /**
18637
+ * 会议室层级
18638
+ */
18639
+ roomLevel: {
18640
+ /**
18641
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=create&version=v1 click to debug }
18642
+ *
18643
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/create document }
18644
+ *
18645
+ * 创建会议室层级
18646
+ *
18647
+ * 该接口用于创建会议室层级
18648
+ */
18649
+ create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18650
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18651
+ return httpInstance
18652
+ .request({
18653
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels`, path),
18654
+ method: "POST",
18655
+ data,
18656
+ params,
18657
+ headers,
18658
+ })
18659
+ .catch((e) => {
18660
+ this.logger.error(formatErrors(e));
18661
+ throw e;
18662
+ });
18663
+ }),
18664
+ /**
18665
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=del&version=v1 click to debug }
18666
+ *
18667
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/del document }
18668
+ *
18669
+ * 删除会议室层级
18670
+ *
18671
+ * 该接口可以用来删除某个会议室层级
18672
+ */
18673
+ del: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18674
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18675
+ return httpInstance
18676
+ .request({
18677
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/del`, path),
18678
+ method: "POST",
18679
+ data,
18680
+ params,
18681
+ headers,
18682
+ })
18683
+ .catch((e) => {
18684
+ this.logger.error(formatErrors(e));
18685
+ throw e;
18686
+ });
18687
+ }),
18688
+ /**
18689
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=get&version=v1 click to debug }
18690
+ *
18691
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/get document }
18692
+ *
18693
+ * 查询会议室层级详情
18694
+ *
18695
+ * 该接口可以使用会议室层级ID查询会议室层级详情
18696
+ */
18697
+ get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18698
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18699
+ return httpInstance
18700
+ .request({
18701
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/:room_level_id`, path),
18702
+ method: "GET",
18703
+ data,
18704
+ params,
18705
+ headers,
18706
+ })
18707
+ .catch((e) => {
18708
+ this.logger.error(formatErrors(e));
18709
+ throw e;
18710
+ });
18711
+ }),
18712
+ listWithIterator: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18713
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18714
+ const sendRequest = (innerPayload) => __awaiter(this, void 0, void 0, function* () {
18715
+ const res = yield httpInstance
18716
+ .request({
18717
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels`, path),
18718
+ method: "GET",
18719
+ headers: pickBy(innerPayload.headers, identity),
18720
+ params: pickBy(innerPayload.params, identity),
18721
+ })
18722
+ .catch((e) => {
18723
+ this.logger.error(formatErrors(e));
18724
+ });
18725
+ return res;
18726
+ });
18727
+ const Iterable = {
18728
+ [Symbol.asyncIterator]() {
18729
+ return __asyncGenerator(this, arguments, function* _a() {
18730
+ let hasMore = true;
18731
+ let pageToken;
18732
+ while (hasMore) {
18733
+ try {
18734
+ const res = yield __await(sendRequest({
18735
+ headers,
18736
+ params: Object.assign(Object.assign({}, params), { page_token: pageToken }),
18737
+ data,
18738
+ }));
18739
+ const _b = get(res, "data") || {}, {
18740
+ // @ts-ignore
18741
+ has_more,
18742
+ // @ts-ignore
18743
+ page_token,
18744
+ // @ts-ignore
18745
+ next_page_token } = _b, rest = __rest(_b, ["has_more", "page_token", "next_page_token"]);
18746
+ yield yield __await(rest);
18747
+ hasMore = Boolean(has_more);
18748
+ pageToken = page_token || next_page_token;
18749
+ }
18750
+ catch (e) {
18751
+ yield yield __await(null);
18752
+ break;
18753
+ }
18754
+ }
18755
+ });
18756
+ },
18757
+ };
18758
+ return Iterable;
18759
+ }),
18760
+ /**
18761
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=list&version=v1 click to debug }
18762
+ *
18763
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/list document }
18764
+ *
18765
+ * 查询会议室层级列表
18766
+ *
18767
+ * 该接口用来查询某个会议室层级下的子层级列表
18768
+ */
18769
+ list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18770
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18771
+ return httpInstance
18772
+ .request({
18773
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels`, path),
18774
+ method: "GET",
18775
+ data,
18776
+ params,
18777
+ headers,
18778
+ })
18779
+ .catch((e) => {
18780
+ this.logger.error(formatErrors(e));
18781
+ throw e;
18782
+ });
18783
+ }),
18784
+ /**
18785
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=mget&version=v1 click to debug }
18786
+ *
18787
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/mget document }
18788
+ *
18789
+ * 批量查询会议室层级详情
18790
+ *
18791
+ * 该接口可以使用会议室层级ID批量查询会议室层级详情
18792
+ */
18793
+ mget: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18794
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18795
+ return httpInstance
18796
+ .request({
18797
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/mget`, path),
18798
+ method: "POST",
18799
+ data,
18800
+ params,
18801
+ headers,
18802
+ })
18803
+ .catch((e) => {
18804
+ this.logger.error(formatErrors(e));
18805
+ throw e;
18806
+ });
18807
+ }),
18808
+ /**
18809
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=patch&version=v1 click to debug }
18810
+ *
18811
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/patch document }
18812
+ *
18813
+ * 更新会议室层级
18814
+ *
18815
+ * 该接口可以用来更新某个会议室层级的信息
18816
+ */
18817
+ patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18818
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18819
+ return httpInstance
18820
+ .request({
18821
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/:room_level_id`, path),
18822
+ method: "PATCH",
18823
+ data,
18824
+ params,
18825
+ headers,
18826
+ })
18827
+ .catch((e) => {
18828
+ this.logger.error(formatErrors(e));
18829
+ throw e;
18830
+ });
18831
+ }),
18832
+ /**
18833
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=search&version=v1 click to debug }
18834
+ *
18835
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/search document }
18836
+ *
18837
+ * 搜索会议室层级
18838
+ *
18839
+ * 该接口可以用来搜索会议室层级,支持使用自定义会议室层级ID进行查询
18840
+ */
18841
+ search: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18842
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18843
+ return httpInstance
18844
+ .request({
18845
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/search`, path),
18846
+ method: "GET",
18847
+ data,
18848
+ params,
18849
+ headers,
18850
+ })
18851
+ .catch((e) => {
18852
+ this.logger.error(formatErrors(e));
18853
+ throw e;
18854
+ });
18855
+ }),
18856
+ },
18857
+ /**
18858
+ * 会议室配置
18859
+ */
18860
+ scopeConfig: {
18861
+ /**
18862
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=scope_config&apiName=create&version=v1 click to debug }
18863
+ *
18864
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/create document }
18865
+ *
18866
+ * 设置会议室配置
18867
+ *
18868
+ * 该接口可以用来设置某个会议层级范围下或者某个会议室的配置
18869
+ */
18870
+ create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18871
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18872
+ return httpInstance
18873
+ .request({
18874
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/scope_config`, path),
18875
+ method: "POST",
18876
+ data,
18877
+ params,
18878
+ headers,
18879
+ })
18880
+ .catch((e) => {
18881
+ this.logger.error(formatErrors(e));
18882
+ throw e;
18883
+ });
18884
+ }),
18885
+ /**
18886
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=scope_config&apiName=get&version=v1 click to debug }
18887
+ *
18888
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/get document }
18889
+ *
18890
+ * 查询会议室配置
18891
+ *
18892
+ * 该接口可以用来查询某个会议层级范围下或者某个会议室的配置
18893
+ */
18894
+ get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18895
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18896
+ return httpInstance
18897
+ .request({
18898
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/scope_config`, path),
18899
+ method: "GET",
18900
+ data,
18901
+ params,
18902
+ headers,
18903
+ })
18904
+ .catch((e) => {
18905
+ this.logger.error(formatErrors(e));
18906
+ throw e;
18907
+ });
18908
+ }),
18315
18909
  },
18316
18910
  };
18317
18911
  /**
@@ -18379,11 +18973,11 @@ class Client$1 {
18379
18973
  *
18380
18974
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node document }
18381
18975
  *
18382
- * 获取节点信息
18976
+ * 获取知识空间节点信息
18383
18977
  *
18384
- * 获取节点信息
18978
+ * 获取知识空间节点信息
18385
18979
  *
18386
- * 知识库权限要求:;- 节点阅读权限
18980
+ * 知识库权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 节点阅读权限
18387
18981
  */
18388
18982
  getNode: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18389
18983
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18486,9 +19080,9 @@ class Client$1 {
18486
19080
  *
18487
19081
  * 添加知识空间成员
18488
19082
  *
18489
- * 添加知识空间成员(管理员)。;;- 公开知识空间(visibility为public)对租户所有用户可见,因此不支持再添加成员,但可以添加管理员。;; 相关错误:131101 public wiki space can't create member.;- 个人知识空间 (type为person)为个人管理的知识空间,不支持添加其他管理员(包括应用/机器人)。但可以添加成员。;; 相关错误:131101 person wiki space can't create admin.
19083
+ * 添加知识空间成员或管理员。
18490
19084
  *
18491
- * 知识库权限要求;- 为知识空间管理员
19085
+ * 知识空间具有[类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)和[可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)的概念。不同的类型或可见性可以对本操作做出限制:;- 可见性限制:公开知识空间(visibility为public)对租户所有用户可见,因此不支持再添加成员,但可以添加管理员。;- 类型限制:个人知识空间 (type为person)为个人管理的知识空间,不支持添加其他管理员(包括应用/机器人)。但可以添加成员。;;;知识空间权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 为知识空间管理员
18492
19086
  */
18493
19087
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18494
19088
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18512,9 +19106,9 @@ class Client$1 {
18512
19106
  *
18513
19107
  * 删除知识空间成员
18514
19108
  *
18515
- * 此接口用于删除知识空间成员。;;- 公开知识空间(visibility为public)对租户所有用户可见,因此不支持再删除成员,但可以删除管理员。;;- 个人知识空间 (type为person)为个人管理的知识空间,不支持删除管理员。但可以删除成员。
19109
+ * 此接口用于删除知识空间成员或管理员。
18516
19110
  *
18517
- * 知识库权限要求;- 为知识空间管理员
19111
+ * 知识空间具有[类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)和[可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)的概念。不同的类型或可见性可以对本操作做出限制:;- 可见性限制:公开知识空间(visibility为public)对租户所有用户可见,因此不支持再删除成员,但可以删除管理员。;- 类型限制:个人知识空间 (type为person)为个人管理的知识空间,不支持删除管理员。但可以删除成员。;;;知识空间权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 为知识空间管理员
18518
19112
  */
18519
19113
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18520
19114
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18541,9 +19135,9 @@ class Client$1 {
18541
19135
  *
18542
19136
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/copy document }
18543
19137
  *
18544
- * 创建节点副本
19138
+ * 创建知识空间节点副本
18545
19139
  *
18546
- * 此接口用于创建节点副本到指定地点。
19140
+ * 此接口用于在知识空间创建节点副本到指定位置。
18547
19141
  */
18548
19142
  copy: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18549
19143
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18565,11 +19159,11 @@ class Client$1 {
18565
19159
  *
18566
19160
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/create document }
18567
19161
  *
18568
- * 创建节点
19162
+ * 创建知识空间节点
18569
19163
  *
18570
- * 此接口用于在知识库里创建节点。
19164
+ * 此接口用于在知识节点里创建[节点](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)到指定位置。
18571
19165
  *
18572
- * 知识库权限要求:;- **父节点**容器编辑权限
19166
+ * 知识空间权限要求,当前使用的 access token 所代表的应用或用户拥有:;- **父节点**容器编辑权限
18573
19167
  */
18574
19168
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18575
19169
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18639,11 +19233,11 @@ class Client$1 {
18639
19233
  *
18640
19234
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/list document }
18641
19235
  *
18642
- * 获取子节点列表
19236
+ * 获取知识空间子节点列表
18643
19237
  *
18644
19238
  * 此接口用于分页获取Wiki节点的子节点列表。;;此接口为分页接口。由于权限过滤,可能返回列表为空,但分页标记(has_more)为true,可以继续分页请求。
18645
19239
  *
18646
- * 知识库权限要求:;- 父节点阅读权限
19240
+ * 知识库权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 父节点阅读权限
18647
19241
  */
18648
19242
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18649
19243
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18691,13 +19285,13 @@ class Client$1 {
18691
19285
  *
18692
19286
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/move_docs_to_wiki document }
18693
19287
  *
18694
- * 添加已有云文档至知识库
19288
+ * 移动云空间文档至知识空间
18695
19289
  *
18696
- * 该接口允许添加已有云文档至知识库,并挂载在指定父页面下
19290
+ * 该接口允许移动云空间文档至知识空间,并挂载在指定位置
18697
19291
  *
18698
- * 仅支持文档所有者发起请求;;此接口为异步接口。若移动已完成(或节点已在Wiki中),则直接返回结果(Wiki token)。若尚未完成,则返回task id。请使用[获取任务结果](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/task/get)接口进行查询。;;知识库权限要求:;- 文档可管理权限;- 原文件夹编辑权限;- 目标父节点容器编辑权限
19292
+ * 此接口为异步接口。若移动已完成(或文档已在Wiki中),则直接返回结果(Wiki token)。若尚未完成,则返回task id。请使用[获取任务结果](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/task/get)接口进行查询。;;知识库权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 文档可管理权限;- 原文件夹编辑权限;- 目标父节点容器编辑权限
18699
19293
  *
18700
- * ### 移动操作 ###;移动后,文档将从“我的空间”或“共享空间”转移至“知识库”,并将从以下功能入口消失:;- 云空间主页:最近访问、快速访问;- 我的空间;- 共享空间;- 收藏;;### 权限变更 ###;移动后,文档会向所有可查看“页面树”的用户显示,默认继承父页面的权限设置。;</md-alert
19294
+ * ### 移动操作 ###;移动后,文档将从“我的空间”或“共享空间”转移至“知识库”后,无法从下列入口查看到文档:;- 云空间主页:快速访问;- 我的空间;- 共享空间;;### 权限变更 ###;移动后,文档会向所有可查看“页面树”的用户显示,默认继承父页面的权限设置。;</md-alert
18701
19295
  */
18702
19296
  moveDocsToWiki: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18703
19297
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18785,7 +19379,7 @@ class Client$1 {
18785
19379
  *
18786
19380
  * 该方法用于获取wiki异步任务的结果
18787
19381
  *
18788
- * 知识库权限要求:;- 为任务创建者(用户或应用/机器人)
19382
+ * 知识库权限要求,当前 access token 所代表的用户或应用(机器人):;- 为任务创建者
18789
19383
  */
18790
19384
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18791
19385
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18946,7 +19540,9 @@ class TokenManager {
18946
19540
  .catch((e) => {
18947
19541
  this.logger.error(e);
18948
19542
  });
18949
- yield ((_b = this.cache) === null || _b === void 0 ? void 0 : _b.set(CTenantAccessToken, tenant_access_token, new Date().getTime() + expire * 1000));
19543
+ yield ((_b = this.cache) === null || _b === void 0 ? void 0 : _b.set(CTenantAccessToken, tenant_access_token,
19544
+ // Due to the time-consuming network, the expiration time needs to be 3 minutes earlier
19545
+ new Date().getTime() + expire * 1000 - 3 * 60 * 1000));
18950
19546
  return tenant_access_token;
18951
19547
  });
18952
19548
  }
@@ -18992,7 +19588,9 @@ class TokenManager {
18992
19588
  this.logger.error(e);
18993
19589
  });
18994
19590
  // 设置tenant_access_token
18995
- yield this.cache.set(`larkMarketAccessToken${tenantKey}`, tenant_access_token, new Date().getTime() + expire * 1000);
19591
+ yield this.cache.set(`larkMarketAccessToken${tenantKey}`, tenant_access_token,
19592
+ // Due to the time-consuming network, the expiration time needs to be 3 minutes earlier
19593
+ new Date().getTime() + expire * 1000 - 3 * 60 * 1000);
18996
19594
  return tenant_access_token;
18997
19595
  });
18998
19596
  }