@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/lib/index.js CHANGED
@@ -576,7 +576,7 @@ class Client$1 {
576
576
  },
577
577
  };
578
578
  /**
579
- * 管理后台-企业勋章
579
+ * 管理后台-数据报表
580
580
  */
581
581
  this.admin = {
582
582
  /**
@@ -1027,6 +1027,83 @@ class Client$1 {
1027
1027
  * 应用信息
1028
1028
  */
1029
1029
  this.application = {
1030
+ /**
1031
+ * 推荐规则
1032
+ */
1033
+ appRecommendRule: {
1034
+ listWithIterator: (payload, options) => __awaiter(this, void 0, void 0, function* () {
1035
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
1036
+ const sendRequest = (innerPayload) => __awaiter(this, void 0, void 0, function* () {
1037
+ const res = yield httpInstance
1038
+ .request({
1039
+ url: fillApiPath(`${this.domain}/open-apis/application/v6/app_recommend_rules`, path),
1040
+ method: "GET",
1041
+ headers: pickBy__default["default"](innerPayload.headers, identity__default["default"]),
1042
+ params: pickBy__default["default"](innerPayload.params, identity__default["default"]),
1043
+ })
1044
+ .catch((e) => {
1045
+ this.logger.error(formatErrors(e));
1046
+ });
1047
+ return res;
1048
+ });
1049
+ const Iterable = {
1050
+ [Symbol.asyncIterator]() {
1051
+ return __asyncGenerator(this, arguments, function* _a() {
1052
+ let hasMore = true;
1053
+ let pageToken;
1054
+ while (hasMore) {
1055
+ try {
1056
+ const res = yield __await(sendRequest({
1057
+ headers,
1058
+ params: Object.assign(Object.assign({}, params), { page_token: pageToken }),
1059
+ data,
1060
+ }));
1061
+ const _b = get__default["default"](res, "data") || {}, {
1062
+ // @ts-ignore
1063
+ has_more,
1064
+ // @ts-ignore
1065
+ page_token,
1066
+ // @ts-ignore
1067
+ next_page_token } = _b, rest = __rest(_b, ["has_more", "page_token", "next_page_token"]);
1068
+ yield yield __await(rest);
1069
+ hasMore = Boolean(has_more);
1070
+ pageToken = page_token || next_page_token;
1071
+ }
1072
+ catch (e) {
1073
+ yield yield __await(null);
1074
+ break;
1075
+ }
1076
+ }
1077
+ });
1078
+ },
1079
+ };
1080
+ return Iterable;
1081
+ }),
1082
+ /**
1083
+ * {@link https://open.feishu.cn/api-explorer?project=application&resource=app_recommend_rule&apiName=list&version=v6 click to debug }
1084
+ *
1085
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/app_recommend_rule/list document }
1086
+ *
1087
+ * 获取当前设置的推荐规则列表
1088
+ *
1089
+ * 获取当前设置的推荐规则列表。
1090
+ */
1091
+ list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
1092
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
1093
+ return httpInstance
1094
+ .request({
1095
+ url: fillApiPath(`${this.domain}/open-apis/application/v6/app_recommend_rules`, path),
1096
+ method: "GET",
1097
+ data,
1098
+ params,
1099
+ headers,
1100
+ })
1101
+ .catch((e) => {
1102
+ this.logger.error(formatErrors(e));
1103
+ throw e;
1104
+ });
1105
+ }),
1106
+ },
1030
1107
  /**
1031
1108
  * 应用使用情况
1032
1109
  */
@@ -1877,7 +1954,7 @@ class Client$1 {
1877
1954
  *
1878
1955
  * 批量获取审批实例ID
1879
1956
  *
1880
- * 根据 approval_code 批量获取审批实例的 instance_code,用于拉取租户下某个审批定义的全部审批实例。默认以审批创建时间排序
1957
+ * 根据 approval_code 批量获取审批实例的 instance_code,用于拉取租户下某个审批定义的全部审批实例。默认以审批创建时间先后顺序排列
1881
1958
  */
1882
1959
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
1883
1960
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -2185,7 +2262,7 @@ class Client$1 {
2185
2262
  }),
2186
2263
  },
2187
2264
  /**
2188
- * 审批查询
2265
+ * 原生审批任务
2189
2266
  */
2190
2267
  task: {
2191
2268
  /**
@@ -2851,7 +2928,7 @@ class Client$1 {
2851
2928
  *
2852
2929
  * 由于部分企业使用的是自己的审批系统,而不是飞书审批系统,因此员工的请假、加班等数据无法流入到飞书考勤系统中,导致员工在请假时间段内依然收到打卡提醒,并且被记为缺卡。;;对于这些只使用飞书考勤系统,而未使用飞书审批系统的企业,可以通过考勤开放接口的形式,将三方审批结果数据回写到飞书考勤系统中。
2853
2930
  *
2854
- * 目前支持写入加班、请假、出差和外出这四种审批结果,写入只会追加(insert),不会覆盖(update)
2931
+ * 目前支持写入加班、请假、出差和外出这四种审批结果,写入只会追加(insert),不会覆盖(update)(开放接口导入的加班假期记录,在管理后台的假期加班里查不到,只能通过[获取审批通过数据](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/user_approval/query)来查询)
2855
2932
  */
2856
2933
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
2857
2934
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -3472,6 +3549,30 @@ class Client$1 {
3472
3549
  throw e;
3473
3550
  });
3474
3551
  }),
3552
+ /**
3553
+ * {@link https://open.feishu.cn/api-explorer?project=baike&resource=entity&apiName=extract&version=v1 click to debug }
3554
+ *
3555
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/baike-v1/entity/extract document }
3556
+ *
3557
+ * 提取潜在的百科词条
3558
+ *
3559
+ * 提取文本中可能成为百科词条的词语,且不会过滤已经成为百科词条的词语。同时,会返回推荐的别名。
3560
+ */
3561
+ extract: (payload, options) => __awaiter(this, void 0, void 0, function* () {
3562
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
3563
+ return httpInstance
3564
+ .request({
3565
+ url: fillApiPath(`${this.domain}/open-apis/baike/v1/entities/extract`, path),
3566
+ method: "POST",
3567
+ data,
3568
+ params,
3569
+ headers,
3570
+ })
3571
+ .catch((e) => {
3572
+ this.logger.error(formatErrors(e));
3573
+ throw e;
3574
+ });
3575
+ }),
3475
3576
  /**
3476
3577
  * {@link https://open.feishu.cn/api-explorer?project=baike&resource=entity&apiName=get&version=v1 click to debug }
3477
3578
  *
@@ -6050,7 +6151,7 @@ class Client$1 {
6050
6151
  *
6051
6152
  * 该接口用于以当前身份(应用 / 用户)获取日历下的日程列表。;身份由 Header Authorization 的 Token 类型决定。
6052
6153
  *
6053
- * - 当前身份必须对日历有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,否则可能造成日程数据缺失。
6154
+ * - 当前身份必须对日历有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,否则可能造成日程数据缺失。
6054
6155
  */
6055
6156
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
6056
6157
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -6709,13 +6810,7 @@ class Client$1 {
6709
6810
  /**
6710
6811
  * {@link https://open.feishu.cn/api-explorer?project=contact&resource=department&apiName=list&version=v3 click to debug }
6711
6812
  *
6712
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/list document }
6713
- *
6714
- * 获取部门信息列表
6715
- *
6716
- * 该接口用于获取当前部门子部门列表。[常见问题答疑](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN)。
6717
- *
6718
- * - 使用 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 决定是否递归)。
6813
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=department&version=v3 document }
6719
6814
  */
6720
6815
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
6721
6816
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -7937,13 +8032,7 @@ class Client$1 {
7937
8032
  /**
7938
8033
  * {@link https://open.feishu.cn/api-explorer?project=contact&resource=user&apiName=list&version=v3 click to debug }
7939
8034
  *
7940
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/list document }
7941
- *
7942
- * 获取用户列表
7943
- *
7944
- * 基于部门ID获取部门下直属用户列表。;[常见问题答疑](https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN)。
7945
- *
7946
- * - 使用 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 参数,则会返回权限范围内的独立用户(权限范围直接包含了某用户,则该用户视为权限范围内的独立用户)。
8035
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=contact&resource=user&version=v3 document }
7947
8036
  */
7948
8037
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
7949
8038
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8439,7 +8528,7 @@ class Client$1 {
8439
8528
  *
8440
8529
  * 创建导出任务
8441
8530
  *
8442
- * 创建导出任务,将云文档导出为文件
8531
+ * 创建导出任务,将云文件导出为指定格式的本地文件。该接口为异步接口,需要通过轮询 [查询导出任务结果](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/get) 接口获取任务结果。
8443
8532
  */
8444
8533
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8445
8534
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8502,7 +8591,7 @@ class Client$1 {
8502
8591
  *
8503
8592
  * 查询导出任务结果
8504
8593
  *
8505
- * 根据创建导出任务的ticket查询导出任务的结果
8594
+ * 根据[创建导出任务](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create)的ticket查询导出任务的结果,前提条件需要先调用创建导出任务接口。;;通过该接口获取到下载文件的 token 后调用[下载导出文件接口](/ssl::ttdoc//uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/download)将文件进行下载
8506
8595
  */
8507
8596
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8508
8597
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8625,9 +8714,9 @@ class Client$1 {
8625
8714
  *
8626
8715
  * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/list document }
8627
8716
  *
8628
- * 获取文档评论
8717
+ * 分页获取文档评论
8629
8718
  *
8630
- * 根据文档token分页获取云文档中的评论。
8719
+ * 该接口用于根据文档 token 分页获取文档评论。
8631
8720
  */
8632
8721
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8633
8722
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -11468,7 +11557,7 @@ class Client$1 {
11468
11557
  /**
11469
11558
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=create&version=v1 click to debug }
11470
11559
  *
11471
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/create_application document }
11560
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/create document }
11472
11561
  *
11473
11562
  * 创建投递
11474
11563
  *
@@ -11492,7 +11581,7 @@ class Client$1 {
11492
11581
  /**
11493
11582
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=get&version=v1 click to debug }
11494
11583
  *
11495
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/get-application document }
11584
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/get document }
11496
11585
  *
11497
11586
  * 获取投递信息
11498
11587
  *
@@ -11516,7 +11605,7 @@ class Client$1 {
11516
11605
  /**
11517
11606
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=list&version=v1 click to debug }
11518
11607
  *
11519
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/get-application-list document }
11608
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/list document }
11520
11609
  *
11521
11610
  * 获取投递列表
11522
11611
  *
@@ -11540,7 +11629,7 @@ class Client$1 {
11540
11629
  /**
11541
11630
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=offer&version=v1 click to debug }
11542
11631
  *
11543
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/get-application-offer document }
11632
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/offer document }
11544
11633
  *
11545
11634
  * 获取 Offer 信息
11546
11635
  *
@@ -11564,7 +11653,7 @@ class Client$1 {
11564
11653
  /**
11565
11654
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=terminate&version=v1 click to debug }
11566
11655
  *
11567
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uQzM1YjL0MTN24CNzUjN/terminate-application document }
11656
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/terminate document }
11568
11657
  *
11569
11658
  * 终止投递
11570
11659
  *
@@ -11588,7 +11677,7 @@ class Client$1 {
11588
11677
  /**
11589
11678
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application&apiName=transfer_onboard&version=v1 click to debug }
11590
11679
  *
11591
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uczM1YjL3MTN24yNzUjN document }
11680
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application/transfer_onboard document }
11592
11681
  *
11593
11682
  * 操作候选人入职
11594
11683
  *
@@ -11611,17 +11700,13 @@ class Client$1 {
11611
11700
  }),
11612
11701
  },
11613
11702
  /**
11614
- * 面试
11703
+ * application.interview
11615
11704
  */
11616
11705
  applicationInterview: {
11617
11706
  /**
11618
11707
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=application.interview&apiName=list&version=v1 click to debug }
11619
11708
  *
11620
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/application-interview/list document }
11621
- *
11622
- * 获取面试记录列表
11623
- *
11624
- * 根据投递 ID 获取面试记录列表
11709
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=list&project=hire&resource=application.interview&version=v1 document }
11625
11710
  */
11626
11711
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
11627
11712
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -11776,7 +11861,7 @@ class Client$1 {
11776
11861
  /**
11777
11862
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=job&apiName=get&version=v1 click to debug }
11778
11863
  *
11779
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/job/get-job document }
11864
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job/get document }
11780
11865
  *
11781
11866
  * 获取职位信息
11782
11867
  *
@@ -11834,7 +11919,7 @@ class Client$1 {
11834
11919
  /**
11835
11920
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=job_process&apiName=list&version=v1 click to debug }
11836
11921
  *
11837
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/jop-process/get-process document }
11922
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/job_process/list document }
11838
11923
  *
11839
11924
  * 获取招聘流程信息
11840
11925
  *
@@ -11958,17 +12043,13 @@ class Client$1 {
11958
12043
  }),
11959
12044
  },
11960
12045
  /**
11961
- * offer
12046
+ * offer_schema
11962
12047
  */
11963
12048
  offerSchema: {
11964
12049
  /**
11965
12050
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=offer_schema&apiName=get&version=v1 click to debug }
11966
12051
  *
11967
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/offer_schema/get document }
11968
- *
11969
- * 获取 Offer 申请表详细信息
11970
- *
11971
- * 根据 Offer 申请表 ID,获取 Offer 申请表的详细信息
12052
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=hire&resource=offer_schema&version=v1 document }
11972
12053
  */
11973
12054
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
11974
12055
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12099,7 +12180,7 @@ class Client$1 {
12099
12180
  /**
12100
12181
  * {@link https://open.feishu.cn/api-explorer?project=hire&resource=talent&apiName=get&version=v1 click to debug }
12101
12182
  *
12102
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUzM1YjL1MTN24SNzUjN/get-talent document }
12183
+ * {@link https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/get document }
12103
12184
  *
12104
12185
  * 获取人才信息
12105
12186
  *
@@ -12258,7 +12339,7 @@ class Client$1 {
12258
12339
  *
12259
12340
  * 获取会话中的群公告信息,公告信息格式与[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。
12260
12341
  *
12261
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app)
12342
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 获取内部群信息时,操作者须与群组在同一租户下
12262
12343
  */
12263
12344
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12264
12345
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12284,7 +12365,7 @@ class Client$1 {
12284
12365
  *
12285
12366
  * 更新会话中的群公告信息,更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。
12286
12367
  *
12287
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置,群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置,所有成员可以更新群公告
12368
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 操作者需要拥有群公告文档的阅读权限;- 获取内部群信息时,操作者须与群组在同一租户下;- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置,群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置,所有成员可以更新群公告
12288
12369
  */
12289
12370
  patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12290
12371
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12341,7 +12422,7 @@ class Client$1 {
12341
12422
  *
12342
12423
  * 解散群组。
12343
12424
  *
12344
- * 注意事项:;- 应用需要开启[机器人能力](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 及事件== 权限
12425
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 如果使用tenant_access_token,需要机器人符合以下任一情况才可解散群:; - 机器人是群主; - 机器人是群的创建者且具备==更新应用所创建群的群信息==权限;- 如果使用user_access_token,需要对应的用户是群主才可解散群
12345
12426
  */
12346
12427
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12347
12428
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12367,7 +12448,7 @@ class Client$1 {
12367
12448
  *
12368
12449
  * 获取群名称、群描述、群头像、群主 ID 等群基本信息。
12369
12450
  *
12370
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群里(否则只会返回群名称、群头像等基本信息);- 获取内部群信息时,操作者须与群组在同一租户下;- 获取外部群信息时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12451
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群里(否则只会返回群名称、群头像等基本信息);- 获取内部群信息时,操作者须与群组在同一租户下
12371
12452
  */
12372
12453
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12373
12454
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12393,7 +12474,7 @@ class Client$1 {
12393
12474
  *
12394
12475
  * 获取指定群的分享链接
12395
12476
  *
12396
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 单聊、密聊、团队群不支持分享群链接;- 当Bot被停用或Bot退出群组时,Bot生成的群链接也将停用;- 当群聊开启了 ==仅群主和群管理员可添加群成员/分享群== 设置时,仅**群主**和**群管理员**可以获取群分享链接;- 获取内部群分享链接时,操作者须与群组在同一租户下;- 获取外部群分享链接时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12477
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 单聊、密聊、团队群不支持分享群链接;- 当Bot被停用或Bot退出群组时,Bot生成的群链接也将停用;- 当群聊开启了 ==仅群主和群管理员可添加群成员/分享群== 设置时,仅**群主**和**群管理员**可以获取群分享链接;- 获取内部群分享链接时,操作者须与群组在同一租户下
12397
12478
  */
12398
12479
  link: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12399
12480
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12467,7 +12548,7 @@ class Client$1 {
12467
12548
  *
12468
12549
  * 获取用户或者机器人所在群列表。
12469
12550
  *
12470
- * 注意事项:; - 应用需要开启[机器人能力](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单聊群
12551
+ * 注意事项:; - 应用需要开启[机器人能力](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单聊
12471
12552
  */
12472
12553
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12473
12554
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12567,7 +12648,7 @@ class Client$1 {
12567
12648
  *
12568
12649
  * 更新群头像、群名称、群描述、群配置、转让群主等。
12569
12650
  *
12570
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 对于群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新所有信息;- 对于不满足上述权限条件的群成员或机器人:; - 若未开启 ==仅群主和群管理员可编辑群信息== 配置,仅可更新群头像、群名称、群描述、群国际化名称信息; - 若开启了 ==仅群主和群管理员可编辑群信息== 配置,任何群信息都不能修改;- 更新外部群信息时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12651
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 对于群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新所有信息;- 对于不满足上述权限条件的群成员或机器人:; - 若未开启 ==仅群主和群管理员可编辑群信息== 配置,仅可更新群头像、群名称、群描述、群国际化名称信息; - 若开启了 ==仅群主和群管理员可编辑群信息== 配置,任何群信息都不能修改
12571
12652
  */
12572
12653
  update: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12573
12654
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12598,7 +12679,7 @@ class Client$1 {
12598
12679
  *
12599
12680
  * 将用户或机器人指定为群管理员。
12600
12681
  *
12601
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以指定群管理员;- 对于普通群,最多指定 10 个管理员;- 对于超大群,最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人;- 指定机器人类型的管理员请使用 ==app_id==
12682
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以指定群管理员
12602
12683
  */
12603
12684
  addManagers: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12604
12685
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12624,7 +12705,7 @@ class Client$1 {
12624
12705
  *
12625
12706
  * 删除指定的群管理员(用户或机器人)。
12626
12707
  *
12627
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以删除群管理员;- 每次请求最多指定 50 个用户或者 5 个机器人;- 删除机器人类型的管理员请使用 ==app_id==
12708
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以删除群管理员
12628
12709
  */
12629
12710
  deleteManagers: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12630
12711
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12655,7 +12736,7 @@ class Client$1 {
12655
12736
  *
12656
12737
  * 将用户或机器人拉入群聊。
12657
12738
  *
12658
- * 注意事项:; - 应用需要开启[机器人能力](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 及事件== 权限; - 在开启 ==仅群主和群管理员可添加群成员== 的设置时,仅有群主/管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可以拉用户或者机器人进群; - 在未开启 ==仅群主和群管理员可添加群成员== 的设置时,所有群成员都可以拉用户或机器人进群
12739
+ * 注意事项:; - 应用需要开启[机器人能力](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); - 机器人或授权用户必须在群组中;- 外部租户不能被加入到内部群中;- 操作内部群时,操作者须与群组在同一租户下; - 在开启 ==仅群主和群管理员可添加群成员== 的设置时,仅有群主/管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可以拉用户或者机器人进群; - 在未开启 ==仅群主和群管理员可添加群成员== 的设置时,所有群成员都可以拉用户或机器人进群
12659
12740
  */
12660
12741
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12661
12742
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12681,7 +12762,7 @@ class Client$1 {
12681
12762
  *
12682
12763
  * 将用户或机器人移出群聊。
12683
12764
  *
12684
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 用户或机器人在任何条件下均可移除自己出群(即主动退群);- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人,可以移除其他用户或者机器人; - 每次请求,最多移除50个用户或者5个机器人
12765
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 用户或机器人在任何条件下均可移除自己出群(即主动退群);- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人,可以移除其他用户或者机器人;- 每次请求,最多移除50个用户或者5个机器人;- 操作内部群时,操作者须与群组在同一租户下
12685
12766
  */
12686
12767
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12687
12768
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12753,9 +12834,9 @@ class Client$1 {
12753
12834
  *
12754
12835
  * 获取群成员列表
12755
12836
  *
12756
- * 如果用户在群中,则返回该群的成员列表。
12837
+ * 获取用户/机器人所在群的群成员列表。
12757
12838
  *
12758
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员,因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员,会一次性返回,这会导致返回的群成员个数可能会大于指定的page_size
12839
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中; - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员,因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员,会一次性返回,这会导致返回的群成员个数可能会大于指定的page_size;- 获取内部群信息时,操作者须与群组在同一租户下
12759
12840
  */
12760
12841
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12761
12842
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12780,6 +12861,8 @@ class Client$1 {
12780
12861
  * 判断用户或机器人是否在群里
12781
12862
  *
12782
12863
  * 根据使用的access_token判断对应的用户或者机器人是否在群里。
12864
+ *
12865
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 获取内部群信息时,操作者须与群组在同一租户下
12783
12866
  */
12784
12867
  isInChat: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12785
12868
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12805,7 +12888,7 @@ class Client$1 {
12805
12888
  *
12806
12889
  * 用户或机器人主动加入群聊。
12807
12890
  *
12808
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 目前仅支持加入公开群
12891
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 目前仅支持加入公开群;- 操作内部群时,操作者须与群组在同一租户下
12809
12892
  */
12810
12893
  meJoin: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12811
12894
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12939,9 +13022,9 @@ class Client$1 {
12939
13022
  *
12940
13023
  * 添加会话标签页
12941
13024
  *
12942
- * 添加自定义会话标签页
13025
+ * 添加自定义会话标签页。
12943
13026
  *
12944
- * 注意事项:;;- 只允许添加类型为docurl的会话标签页;;- 创建时不需要设置tabID;;- 一个群内最多只允许添加20个自定义会话标签页;;- 会话标签页的名称不超过30个字符;;- 添加doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限
13027
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许添加类型为`doc`和`url`的会话标签页;- 添加doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限;- tab_config字段当前只对`url`类型的会话标签页生效;- 在开启 ==仅群主和管理员可管理标签页== 的设置时,仅群主和群管理员可以添加会话标签页;- 操作内部群时,操作者须与群组在同一租户下
12945
13028
  */
12946
13029
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12947
13030
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12965,7 +13048,9 @@ class Client$1 {
12965
13048
  *
12966
13049
  * 删除会话标签页
12967
13050
  *
12968
- * 删除会话标签页
13051
+ * 删除会话标签页。
13052
+ *
13053
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许删除类型为`doc`和`url`的会话标签页;- 在开启 ==仅群主和管理员可管理标签页== 的设置时,仅群主和群管理员可以删除会话标签页;- 操作内部群时,操作者须与群组在同一租户下
12969
13054
  */
12970
13055
  deleteTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12971
13056
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12989,7 +13074,9 @@ class Client$1 {
12989
13074
  *
12990
13075
  * 拉取会话标签页
12991
13076
  *
12992
- * 拉取会话标签页
13077
+ * 拉取会话标签页。
13078
+ *
13079
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 操作内部群时,操作者须与群组在同一租户下
12993
13080
  */
12994
13081
  listTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12995
13082
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13013,9 +13100,9 @@ class Client$1 {
13013
13100
  *
13014
13101
  * 会话标签页排序
13015
13102
  *
13016
- * 会话标签页排序
13103
+ * 会话标签页排序。
13017
13104
  *
13018
- * 注意事项:;;- 当前消息标签页固定为第一顺位,不参与排序,但是请求体中必须包含。;;- 请求体必须包含全部的TabID
13105
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 消息标签页强制固定为第一顺位,不参与排序,但是请求体中必须包含该标签页的Tab ID;- 操作内部群时,操作者须与群组在同一租户下
13019
13106
  */
13020
13107
  sortTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13021
13108
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13041,7 +13128,7 @@ class Client$1 {
13041
13128
  *
13042
13129
  * 更新会话标签页
13043
13130
  *
13044
- * 注意事项:;;- 只允许更新类型为docurl的会话标签页;;- 会话标签页的名称不超过30个字符;;- 更新doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限
13131
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许更新类型为`doc`和`url`的会话标签页;- 更新doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限;- 在开启 ==仅群主和管理员可管理标签页== 的设置时,仅群主和群管理员可以更新会话标签页;- 操作内部群时,操作者须与群组在同一租户下
13045
13132
  */
13046
13133
  updateTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13047
13134
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13072,7 +13159,7 @@ class Client$1 {
13072
13159
  *
13073
13160
  * 撤销会话中的置顶。
13074
13161
  *
13075
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 撤销内部群置顶时,操作者须与群组在同一租户下;- 撤销外部群置顶时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
13162
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 撤销内部群置顶时,操作者须与群组在同一租户下
13076
13163
  */
13077
13164
  deleteTopNotice: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13078
13165
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13098,7 +13185,7 @@ class Client$1 {
13098
13185
  *
13099
13186
  * 更新会话中的群置顶信息,可以将群中的某一条消息,或者群公告置顶显示。
13100
13187
  *
13101
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 更新内部群置顶时,操作者须与群组在同一租户下;- 更新外部群置顶时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
13188
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中;- 更新内部群置顶时,操作者须与群组在同一租户下
13102
13189
  */
13103
13190
  putTopNotice: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13104
13191
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13263,7 +13350,7 @@ class Client$1 {
13263
13350
  }),
13264
13351
  },
13265
13352
  /**
13266
- * 消息 - 消息卡片
13353
+ * 消息加急
13267
13354
  */
13268
13355
  message: {
13269
13356
  /**
@@ -13395,7 +13482,7 @@ class Client$1 {
13395
13482
  /**
13396
13483
  * {@link https://open.feishu.cn/api-explorer?project=im&resource=message&apiName=list&version=v1 click to debug }
13397
13484
  *
13398
- * {@link https://open.feishu.cn/document/ukTMukTMukTM/uADO3YjLwgzN24CM4cjN document }
13485
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list document }
13399
13486
  *
13400
13487
  * 获取会话历史消息
13401
13488
  *
@@ -13403,7 +13490,7 @@ class Client$1 {
13403
13490
  *
13404
13491
  * - 需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app) ;- 获取消息时,机器人必须在群组中
13405
13492
  *
13406
- * 接口级别权限默认只能获取单聊(p2p)消息,如果需要获取群组(group)消息,应用还必须拥有 ***获取群组中所有消息*** 权限
13493
+ * 接口级别权限默认只能获取单聊(p2p)消息,如果需要获取群组(group)消息,应用还必须拥有 **==获取群组中所有消息==** 权限
13407
13494
  */
13408
13495
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13409
13496
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13429,7 +13516,7 @@ class Client$1 {
13429
13516
  *
13430
13517
  * 更新应用已发送的消息卡片内容。
13431
13518
  *
13432
- * 注意事项:;- 需要开启[机器人能力](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**
13519
+ * 注意事项:;- 需要开启[机器人能力](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**
13433
13520
  */
13434
13521
  patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13435
13522
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -15805,7 +15892,7 @@ class Client$1 {
15805
15892
  *
15806
15893
  * 创建表格
15807
15894
  *
15808
- * 使用该接口可以在指定的目录下创建在线表格。
15895
+ * 在指定目录下创建表格
15809
15896
  */
15810
15897
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
15811
15898
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16239,7 +16326,7 @@ class Client$1 {
16239
16326
  }),
16240
16327
  },
16241
16328
  /**
16242
- * 行列
16329
+ * 工作表
16243
16330
  */
16244
16331
  spreadsheetSheet: {
16245
16332
  /**
@@ -16249,7 +16336,7 @@ class Client$1 {
16249
16336
  *
16250
16337
  * 查找单元格
16251
16338
  *
16252
- * 按照指定的条件查找子表的某个范围内的数据符合条件的单元格位置。请求体中的 range 和 find 字段为必填。
16339
+ * 在指定范围内查找符合查找条件的单元格。
16253
16340
  */
16254
16341
  find: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16255
16342
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16630,7 +16717,7 @@ class Client$1 {
16630
16717
  *
16631
16718
  * 完成任务
16632
16719
  *
16633
- * 该接口用于将任务状态修改为”已完成“
16720
+ * 该接口用于将任务状态修改为“已完成”。;完成任务是指整个任务全部完成,而不支持执行者分别完成任务,执行成功后,任务对所有关联用户都变为完成状态。
16634
16721
  */
16635
16722
  complete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16636
16723
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16654,7 +16741,7 @@ class Client$1 {
16654
16741
  *
16655
16742
  * 创建任务
16656
16743
  *
16657
- * 该接口可以创建一个任务(基本信息),如果需要绑定协作者等需要调用别的资源管理接口。其中查询字段 user_id_type 是用于控制返回体中 creator_id 的类型,不传时默认返回 open_id。当使用tenant_access_token 调用接口时,如果user_id_type为user_id,则不会返回creator_id。
16744
+ * 该接口可以创建一个任务,支持填写任务的基本信息,包括任务的标题,描述及协作者等。;在此基础上,创建任务时可以设置截止时间和重复规则,将任务设置为定期执行的重复任务。通过添加协作者,则可以让其他用户协同完成该任务。;此外,接口也提供了一些支持自定义内容的字段,调用方可以实现定制化效果,如完成任务后跳转到指定结束界面。
16658
16745
  */
16659
16746
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16660
16747
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16851,7 +16938,7 @@ class Client$1 {
16851
16938
  *
16852
16939
  * 新增执行者
16853
16940
  *
16854
- * 该接口用于新增任务执行者,一次性可以添加多个执行者。新增的执行者必须是用户的ID。
16941
+ * 该接口用于新增任务执行者,一次性可以添加多个执行者。;只有任务的创建者和执行者才能添加执行者,关注人无权限添加。
16855
16942
  */
16856
16943
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16857
16944
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -17711,6 +17798,30 @@ class Client$1 {
17711
17798
  throw e;
17712
17799
  });
17713
17800
  }),
17801
+ /**
17802
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=export&apiName=resource_reservation_list&version=v1 click to debug }
17803
+ *
17804
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/resource_reservation_list document }
17805
+ *
17806
+ * 导出会议室预定数据
17807
+ *
17808
+ * 导出会议室预定数据,具体权限要求请参考「导出概述」
17809
+ */
17810
+ resourceReservationList: (payload, options) => __awaiter(this, void 0, void 0, function* () {
17811
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
17812
+ return httpInstance
17813
+ .request({
17814
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/exports/resource_reservation_list`, path),
17815
+ method: "POST",
17816
+ data,
17817
+ params,
17818
+ headers,
17819
+ })
17820
+ .catch((e) => {
17821
+ this.logger.error(formatErrors(e));
17822
+ throw e;
17823
+ });
17824
+ }),
17714
17825
  },
17715
17826
  /**
17716
17827
  * 会议
@@ -18219,7 +18330,7 @@ class Client$1 {
18219
18330
  }),
18220
18331
  },
18221
18332
  /**
18222
- * 会议室预定范围
18333
+ * reserve_config
18223
18334
  */
18224
18335
  reserveConfig: {
18225
18336
  /**
@@ -18272,25 +18383,71 @@ class Client$1 {
18272
18383
  }),
18273
18384
  },
18274
18385
  /**
18275
- * 会议室配置
18386
+ * 会议室
18276
18387
  */
18277
- roomConfig: {
18388
+ room: {
18278
18389
  /**
18279
- * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=query&version=v1 click to debug }
18390
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=create&version=v1 click to debug }
18280
18391
  *
18281
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_config/query document }
18392
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/create document }
18282
18393
  *
18283
- * 查询会议室配置
18394
+ * 创建会议室
18395
+ *
18396
+ * 该接口用于创建会议室
18397
+ */
18398
+ create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18399
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18400
+ return httpInstance
18401
+ .request({
18402
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms`, path),
18403
+ method: "POST",
18404
+ data,
18405
+ params,
18406
+ headers,
18407
+ })
18408
+ .catch((e) => {
18409
+ this.logger.error(formatErrors(e));
18410
+ throw e;
18411
+ });
18412
+ }),
18413
+ /**
18414
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=delete&version=v1 click to debug }
18415
+ *
18416
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/delete document }
18284
18417
  *
18285
- * 查询一个范围内的会议室配置。
18418
+ * 删除会议室
18286
18419
  *
18287
- * 根据查询范围传入对应的参数
18420
+ * 该接口可以用来删除某个会议室
18288
18421
  */
18289
- query: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18422
+ delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18290
18423
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
18291
18424
  return httpInstance
18292
18425
  .request({
18293
- url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/query`, path),
18426
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/:room_id`, path),
18427
+ method: "DELETE",
18428
+ data,
18429
+ params,
18430
+ headers,
18431
+ })
18432
+ .catch((e) => {
18433
+ this.logger.error(formatErrors(e));
18434
+ throw e;
18435
+ });
18436
+ }),
18437
+ /**
18438
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=get&version=v1 click to debug }
18439
+ *
18440
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/get document }
18441
+ *
18442
+ * 查询会议室详情
18443
+ *
18444
+ * 该接口可以使用会议室ID查询会议室详情
18445
+ */
18446
+ get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18447
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18448
+ return httpInstance
18449
+ .request({
18450
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/:room_id`, path),
18294
18451
  method: "GET",
18295
18452
  data,
18296
18453
  params,
@@ -18301,22 +18458,92 @@ class Client$1 {
18301
18458
  throw e;
18302
18459
  });
18303
18460
  }),
18461
+ listWithIterator: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18462
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18463
+ const sendRequest = (innerPayload) => __awaiter(this, void 0, void 0, function* () {
18464
+ const res = yield httpInstance
18465
+ .request({
18466
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms`, path),
18467
+ method: "GET",
18468
+ headers: pickBy__default["default"](innerPayload.headers, identity__default["default"]),
18469
+ params: pickBy__default["default"](innerPayload.params, identity__default["default"]),
18470
+ })
18471
+ .catch((e) => {
18472
+ this.logger.error(formatErrors(e));
18473
+ });
18474
+ return res;
18475
+ });
18476
+ const Iterable = {
18477
+ [Symbol.asyncIterator]() {
18478
+ return __asyncGenerator(this, arguments, function* _a() {
18479
+ let hasMore = true;
18480
+ let pageToken;
18481
+ while (hasMore) {
18482
+ try {
18483
+ const res = yield __await(sendRequest({
18484
+ headers,
18485
+ params: Object.assign(Object.assign({}, params), { page_token: pageToken }),
18486
+ data,
18487
+ }));
18488
+ const _b = get__default["default"](res, "data") || {}, {
18489
+ // @ts-ignore
18490
+ has_more,
18491
+ // @ts-ignore
18492
+ page_token,
18493
+ // @ts-ignore
18494
+ next_page_token } = _b, rest = __rest(_b, ["has_more", "page_token", "next_page_token"]);
18495
+ yield yield __await(rest);
18496
+ hasMore = Boolean(has_more);
18497
+ pageToken = page_token || next_page_token;
18498
+ }
18499
+ catch (e) {
18500
+ yield yield __await(null);
18501
+ break;
18502
+ }
18503
+ }
18504
+ });
18505
+ },
18506
+ };
18507
+ return Iterable;
18508
+ }),
18304
18509
  /**
18305
- * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=set&version=v1 click to debug }
18510
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=list&version=v1 click to debug }
18306
18511
  *
18307
- * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_config/set document }
18512
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/list document }
18308
18513
  *
18309
- * 设置会议室配置
18514
+ * 查询会议室列表
18515
+ *
18516
+ * 该接口可以用来查询某个会议室层级下会议室列表
18517
+ */
18518
+ list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18519
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18520
+ return httpInstance
18521
+ .request({
18522
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms`, path),
18523
+ method: "GET",
18524
+ data,
18525
+ params,
18526
+ headers,
18527
+ })
18528
+ .catch((e) => {
18529
+ this.logger.error(formatErrors(e));
18530
+ throw e;
18531
+ });
18532
+ }),
18533
+ /**
18534
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=mget&version=v1 click to debug }
18310
18535
  *
18311
- * 设置一个范围内的会议室配置。
18536
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/mget document }
18312
18537
  *
18313
- * 根据设置范围传入对应的参数
18538
+ * 批量查询会议室详情
18539
+ *
18540
+ * 该接口可以使用会议室ID批量查询会议室详情
18314
18541
  */
18315
- set: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18542
+ mget: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18316
18543
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
18317
18544
  return httpInstance
18318
18545
  .request({
18319
- url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/set`, path),
18546
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/mget`, path),
18320
18547
  method: "POST",
18321
18548
  data,
18322
18549
  params,
@@ -18327,6 +18554,373 @@ class Client$1 {
18327
18554
  throw e;
18328
18555
  });
18329
18556
  }),
18557
+ /**
18558
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=patch&version=v1 click to debug }
18559
+ *
18560
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/patch document }
18561
+ *
18562
+ * 更新会议室
18563
+ *
18564
+ * 该接口可以用来更新某个会议室的信息
18565
+ */
18566
+ patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18567
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18568
+ return httpInstance
18569
+ .request({
18570
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/:room_id`, path),
18571
+ method: "PATCH",
18572
+ data,
18573
+ params,
18574
+ headers,
18575
+ })
18576
+ .catch((e) => {
18577
+ this.logger.error(formatErrors(e));
18578
+ throw e;
18579
+ });
18580
+ }),
18581
+ /**
18582
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room&apiName=search&version=v1 click to debug }
18583
+ *
18584
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room/search document }
18585
+ *
18586
+ * 搜索会议室
18587
+ *
18588
+ * 该接口可以用来搜索会议室,支持使用关键词进行搜索,也支持使用自定义会议室ID进行查询
18589
+ */
18590
+ search: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18591
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18592
+ return httpInstance
18593
+ .request({
18594
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/rooms/search`, path),
18595
+ method: "POST",
18596
+ data,
18597
+ params,
18598
+ headers,
18599
+ })
18600
+ .catch((e) => {
18601
+ this.logger.error(formatErrors(e));
18602
+ throw e;
18603
+ });
18604
+ }),
18605
+ },
18606
+ /**
18607
+ * room_config
18608
+ */
18609
+ roomConfig: {
18610
+ /**
18611
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=query&version=v1 click to debug }
18612
+ *
18613
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=query&project=vc&resource=room_config&version=v1 document }
18614
+ */
18615
+ query: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18616
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18617
+ return httpInstance
18618
+ .request({
18619
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/query`, path),
18620
+ method: "GET",
18621
+ data,
18622
+ params,
18623
+ headers,
18624
+ })
18625
+ .catch((e) => {
18626
+ this.logger.error(formatErrors(e));
18627
+ throw e;
18628
+ });
18629
+ }),
18630
+ /**
18631
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_config&apiName=set&version=v1 click to debug }
18632
+ *
18633
+ * {@link https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=set&project=vc&resource=room_config&version=v1 document }
18634
+ */
18635
+ set: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18636
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18637
+ return httpInstance
18638
+ .request({
18639
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_configs/set`, path),
18640
+ method: "POST",
18641
+ data,
18642
+ params,
18643
+ headers,
18644
+ })
18645
+ .catch((e) => {
18646
+ this.logger.error(formatErrors(e));
18647
+ throw e;
18648
+ });
18649
+ }),
18650
+ },
18651
+ /**
18652
+ * 会议室层级
18653
+ */
18654
+ roomLevel: {
18655
+ /**
18656
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=create&version=v1 click to debug }
18657
+ *
18658
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/create document }
18659
+ *
18660
+ * 创建会议室层级
18661
+ *
18662
+ * 该接口用于创建会议室层级
18663
+ */
18664
+ create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18665
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18666
+ return httpInstance
18667
+ .request({
18668
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels`, path),
18669
+ method: "POST",
18670
+ data,
18671
+ params,
18672
+ headers,
18673
+ })
18674
+ .catch((e) => {
18675
+ this.logger.error(formatErrors(e));
18676
+ throw e;
18677
+ });
18678
+ }),
18679
+ /**
18680
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=del&version=v1 click to debug }
18681
+ *
18682
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/del document }
18683
+ *
18684
+ * 删除会议室层级
18685
+ *
18686
+ * 该接口可以用来删除某个会议室层级
18687
+ */
18688
+ del: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18689
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18690
+ return httpInstance
18691
+ .request({
18692
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/del`, path),
18693
+ method: "POST",
18694
+ data,
18695
+ params,
18696
+ headers,
18697
+ })
18698
+ .catch((e) => {
18699
+ this.logger.error(formatErrors(e));
18700
+ throw e;
18701
+ });
18702
+ }),
18703
+ /**
18704
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=get&version=v1 click to debug }
18705
+ *
18706
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/get document }
18707
+ *
18708
+ * 查询会议室层级详情
18709
+ *
18710
+ * 该接口可以使用会议室层级ID查询会议室层级详情
18711
+ */
18712
+ get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18713
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18714
+ return httpInstance
18715
+ .request({
18716
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/:room_level_id`, path),
18717
+ method: "GET",
18718
+ data,
18719
+ params,
18720
+ headers,
18721
+ })
18722
+ .catch((e) => {
18723
+ this.logger.error(formatErrors(e));
18724
+ throw e;
18725
+ });
18726
+ }),
18727
+ listWithIterator: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18728
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18729
+ const sendRequest = (innerPayload) => __awaiter(this, void 0, void 0, function* () {
18730
+ const res = yield httpInstance
18731
+ .request({
18732
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels`, path),
18733
+ method: "GET",
18734
+ headers: pickBy__default["default"](innerPayload.headers, identity__default["default"]),
18735
+ params: pickBy__default["default"](innerPayload.params, identity__default["default"]),
18736
+ })
18737
+ .catch((e) => {
18738
+ this.logger.error(formatErrors(e));
18739
+ });
18740
+ return res;
18741
+ });
18742
+ const Iterable = {
18743
+ [Symbol.asyncIterator]() {
18744
+ return __asyncGenerator(this, arguments, function* _a() {
18745
+ let hasMore = true;
18746
+ let pageToken;
18747
+ while (hasMore) {
18748
+ try {
18749
+ const res = yield __await(sendRequest({
18750
+ headers,
18751
+ params: Object.assign(Object.assign({}, params), { page_token: pageToken }),
18752
+ data,
18753
+ }));
18754
+ const _b = get__default["default"](res, "data") || {}, {
18755
+ // @ts-ignore
18756
+ has_more,
18757
+ // @ts-ignore
18758
+ page_token,
18759
+ // @ts-ignore
18760
+ next_page_token } = _b, rest = __rest(_b, ["has_more", "page_token", "next_page_token"]);
18761
+ yield yield __await(rest);
18762
+ hasMore = Boolean(has_more);
18763
+ pageToken = page_token || next_page_token;
18764
+ }
18765
+ catch (e) {
18766
+ yield yield __await(null);
18767
+ break;
18768
+ }
18769
+ }
18770
+ });
18771
+ },
18772
+ };
18773
+ return Iterable;
18774
+ }),
18775
+ /**
18776
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=list&version=v1 click to debug }
18777
+ *
18778
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/list document }
18779
+ *
18780
+ * 查询会议室层级列表
18781
+ *
18782
+ * 该接口用来查询某个会议室层级下的子层级列表
18783
+ */
18784
+ list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18785
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18786
+ return httpInstance
18787
+ .request({
18788
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels`, path),
18789
+ method: "GET",
18790
+ data,
18791
+ params,
18792
+ headers,
18793
+ })
18794
+ .catch((e) => {
18795
+ this.logger.error(formatErrors(e));
18796
+ throw e;
18797
+ });
18798
+ }),
18799
+ /**
18800
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=mget&version=v1 click to debug }
18801
+ *
18802
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/mget document }
18803
+ *
18804
+ * 批量查询会议室层级详情
18805
+ *
18806
+ * 该接口可以使用会议室层级ID批量查询会议室层级详情
18807
+ */
18808
+ mget: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18809
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18810
+ return httpInstance
18811
+ .request({
18812
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/mget`, path),
18813
+ method: "POST",
18814
+ data,
18815
+ params,
18816
+ headers,
18817
+ })
18818
+ .catch((e) => {
18819
+ this.logger.error(formatErrors(e));
18820
+ throw e;
18821
+ });
18822
+ }),
18823
+ /**
18824
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=patch&version=v1 click to debug }
18825
+ *
18826
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/patch document }
18827
+ *
18828
+ * 更新会议室层级
18829
+ *
18830
+ * 该接口可以用来更新某个会议室层级的信息
18831
+ */
18832
+ patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18833
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18834
+ return httpInstance
18835
+ .request({
18836
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/:room_level_id`, path),
18837
+ method: "PATCH",
18838
+ data,
18839
+ params,
18840
+ headers,
18841
+ })
18842
+ .catch((e) => {
18843
+ this.logger.error(formatErrors(e));
18844
+ throw e;
18845
+ });
18846
+ }),
18847
+ /**
18848
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=room_level&apiName=search&version=v1 click to debug }
18849
+ *
18850
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/room_level/search document }
18851
+ *
18852
+ * 搜索会议室层级
18853
+ *
18854
+ * 该接口可以用来搜索会议室层级,支持使用自定义会议室层级ID进行查询
18855
+ */
18856
+ search: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18857
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18858
+ return httpInstance
18859
+ .request({
18860
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/room_levels/search`, path),
18861
+ method: "GET",
18862
+ data,
18863
+ params,
18864
+ headers,
18865
+ })
18866
+ .catch((e) => {
18867
+ this.logger.error(formatErrors(e));
18868
+ throw e;
18869
+ });
18870
+ }),
18871
+ },
18872
+ /**
18873
+ * 会议室配置
18874
+ */
18875
+ scopeConfig: {
18876
+ /**
18877
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=scope_config&apiName=create&version=v1 click to debug }
18878
+ *
18879
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/create document }
18880
+ *
18881
+ * 设置会议室配置
18882
+ *
18883
+ * 该接口可以用来设置某个会议层级范围下或者某个会议室的配置
18884
+ */
18885
+ create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18886
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18887
+ return httpInstance
18888
+ .request({
18889
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/scope_config`, path),
18890
+ method: "POST",
18891
+ data,
18892
+ params,
18893
+ headers,
18894
+ })
18895
+ .catch((e) => {
18896
+ this.logger.error(formatErrors(e));
18897
+ throw e;
18898
+ });
18899
+ }),
18900
+ /**
18901
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=scope_config&apiName=get&version=v1 click to debug }
18902
+ *
18903
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/scope_config/get document }
18904
+ *
18905
+ * 查询会议室配置
18906
+ *
18907
+ * 该接口可以用来查询某个会议层级范围下或者某个会议室的配置
18908
+ */
18909
+ get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18910
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
18911
+ return httpInstance
18912
+ .request({
18913
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/scope_config`, path),
18914
+ method: "GET",
18915
+ data,
18916
+ params,
18917
+ headers,
18918
+ })
18919
+ .catch((e) => {
18920
+ this.logger.error(formatErrors(e));
18921
+ throw e;
18922
+ });
18923
+ }),
18330
18924
  },
18331
18925
  };
18332
18926
  /**
@@ -18394,11 +18988,11 @@ class Client$1 {
18394
18988
  *
18395
18989
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space/get_node document }
18396
18990
  *
18397
- * 获取节点信息
18991
+ * 获取知识空间节点信息
18398
18992
  *
18399
- * 获取节点信息
18993
+ * 获取知识空间节点信息
18400
18994
  *
18401
- * 知识库权限要求:;- 节点阅读权限
18995
+ * 知识库权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 节点阅读权限
18402
18996
  */
18403
18997
  getNode: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18404
18998
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18501,9 +19095,9 @@ class Client$1 {
18501
19095
  *
18502
19096
  * 添加知识空间成员
18503
19097
  *
18504
- * 添加知识空间成员(管理员)。;;- 公开知识空间(visibility为public)对租户所有用户可见,因此不支持再添加成员,但可以添加管理员。;; 相关错误:131101 public wiki space can't create member.;- 个人知识空间 (type为person)为个人管理的知识空间,不支持添加其他管理员(包括应用/机器人)。但可以添加成员。;; 相关错误:131101 person wiki space can't create admin.
19098
+ * 添加知识空间成员或管理员。
18505
19099
  *
18506
- * 知识库权限要求;- 为知识空间管理员
19100
+ * 知识空间具有[类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)和[可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)的概念。不同的类型或可见性可以对本操作做出限制:;- 可见性限制:公开知识空间(visibility为public)对租户所有用户可见,因此不支持再添加成员,但可以添加管理员。;- 类型限制:个人知识空间 (type为person)为个人管理的知识空间,不支持添加其他管理员(包括应用/机器人)。但可以添加成员。;;;知识空间权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 为知识空间管理员
18507
19101
  */
18508
19102
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18509
19103
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18527,9 +19121,9 @@ class Client$1 {
18527
19121
  *
18528
19122
  * 删除知识空间成员
18529
19123
  *
18530
- * 此接口用于删除知识空间成员。;;- 公开知识空间(visibility为public)对租户所有用户可见,因此不支持再删除成员,但可以删除管理员。;;- 个人知识空间 (type为person)为个人管理的知识空间,不支持删除管理员。但可以删除成员。
19124
+ * 此接口用于删除知识空间成员或管理员。
18531
19125
  *
18532
- * 知识库权限要求;- 为知识空间管理员
19126
+ * 知识空间具有[类型](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)和[可见性](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)的概念。不同的类型或可见性可以对本操作做出限制:;- 可见性限制:公开知识空间(visibility为public)对租户所有用户可见,因此不支持再删除成员,但可以删除管理员。;- 类型限制:个人知识空间 (type为person)为个人管理的知识空间,不支持删除管理员。但可以删除成员。;;;知识空间权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 为知识空间管理员
18533
19127
  */
18534
19128
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18535
19129
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18556,9 +19150,9 @@ class Client$1 {
18556
19150
  *
18557
19151
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/copy document }
18558
19152
  *
18559
- * 创建节点副本
19153
+ * 创建知识空间节点副本
18560
19154
  *
18561
- * 此接口用于创建节点副本到指定地点。
19155
+ * 此接口用于在知识空间创建节点副本到指定位置。
18562
19156
  */
18563
19157
  copy: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18564
19158
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18580,11 +19174,11 @@ class Client$1 {
18580
19174
  *
18581
19175
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/create document }
18582
19176
  *
18583
- * 创建节点
19177
+ * 创建知识空间节点
18584
19178
  *
18585
- * 此接口用于在知识库里创建节点。
19179
+ * 此接口用于在知识节点里创建[节点](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-overview)到指定位置。
18586
19180
  *
18587
- * 知识库权限要求:;- **父节点**容器编辑权限
19181
+ * 知识空间权限要求,当前使用的 access token 所代表的应用或用户拥有:;- **父节点**容器编辑权限
18588
19182
  */
18589
19183
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18590
19184
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18654,11 +19248,11 @@ class Client$1 {
18654
19248
  *
18655
19249
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/list document }
18656
19250
  *
18657
- * 获取子节点列表
19251
+ * 获取知识空间子节点列表
18658
19252
  *
18659
19253
  * 此接口用于分页获取Wiki节点的子节点列表。;;此接口为分页接口。由于权限过滤,可能返回列表为空,但分页标记(has_more)为true,可以继续分页请求。
18660
19254
  *
18661
- * 知识库权限要求:;- 父节点阅读权限
19255
+ * 知识库权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 父节点阅读权限
18662
19256
  */
18663
19257
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18664
19258
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18706,13 +19300,13 @@ class Client$1 {
18706
19300
  *
18707
19301
  * {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/space-node/move_docs_to_wiki document }
18708
19302
  *
18709
- * 添加已有云文档至知识库
19303
+ * 移动云空间文档至知识空间
18710
19304
  *
18711
- * 该接口允许添加已有云文档至知识库,并挂载在指定父页面下
19305
+ * 该接口允许移动云空间文档至知识空间,并挂载在指定位置
18712
19306
  *
18713
- * 仅支持文档所有者发起请求;;此接口为异步接口。若移动已完成(或节点已在Wiki中),则直接返回结果(Wiki token)。若尚未完成,则返回task id。请使用[获取任务结果](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/task/get)接口进行查询。;;知识库权限要求:;- 文档可管理权限;- 原文件夹编辑权限;- 目标父节点容器编辑权限
19307
+ * 此接口为异步接口。若移动已完成(或文档已在Wiki中),则直接返回结果(Wiki token)。若尚未完成,则返回task id。请使用[获取任务结果](https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/wiki-v2/task/get)接口进行查询。;;知识库权限要求,当前使用的 access token 所代表的应用或用户拥有:;- 文档可管理权限;- 原文件夹编辑权限;- 目标父节点容器编辑权限
18714
19308
  *
18715
- * ### 移动操作 ###;移动后,文档将从“我的空间”或“共享空间”转移至“知识库”,并将从以下功能入口消失:;- 云空间主页:最近访问、快速访问;- 我的空间;- 共享空间;- 收藏;;### 权限变更 ###;移动后,文档会向所有可查看“页面树”的用户显示,默认继承父页面的权限设置。;</md-alert
19309
+ * ### 移动操作 ###;移动后,文档将从“我的空间”或“共享空间”转移至“知识库”后,无法从下列入口查看到文档:;- 云空间主页:快速访问;- 我的空间;- 共享空间;;### 权限变更 ###;移动后,文档会向所有可查看“页面树”的用户显示,默认继承父页面的权限设置。;</md-alert
18716
19310
  */
18717
19311
  moveDocsToWiki: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18718
19312
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18800,7 +19394,7 @@ class Client$1 {
18800
19394
  *
18801
19395
  * 该方法用于获取wiki异步任务的结果
18802
19396
  *
18803
- * 知识库权限要求:;- 为任务创建者(用户或应用/机器人)
19397
+ * 知识库权限要求,当前 access token 所代表的用户或应用(机器人):;- 为任务创建者
18804
19398
  */
18805
19399
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
18806
19400
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -18961,7 +19555,9 @@ class TokenManager {
18961
19555
  .catch((e) => {
18962
19556
  this.logger.error(e);
18963
19557
  });
18964
- yield ((_b = this.cache) === null || _b === void 0 ? void 0 : _b.set(CTenantAccessToken, tenant_access_token, new Date().getTime() + expire * 1000));
19558
+ yield ((_b = this.cache) === null || _b === void 0 ? void 0 : _b.set(CTenantAccessToken, tenant_access_token,
19559
+ // Due to the time-consuming network, the expiration time needs to be 3 minutes earlier
19560
+ new Date().getTime() + expire * 1000 - 3 * 60 * 1000));
18965
19561
  return tenant_access_token;
18966
19562
  });
18967
19563
  }
@@ -19007,7 +19603,9 @@ class TokenManager {
19007
19603
  this.logger.error(e);
19008
19604
  });
19009
19605
  // 设置tenant_access_token
19010
- yield this.cache.set(`larkMarketAccessToken${tenantKey}`, tenant_access_token, new Date().getTime() + expire * 1000);
19606
+ yield this.cache.set(`larkMarketAccessToken${tenantKey}`, tenant_access_token,
19607
+ // Due to the time-consuming network, the expiration time needs to be 3 minutes earlier
19608
+ new Date().getTime() + expire * 1000 - 3 * 60 * 1000);
19011
19609
  return tenant_access_token;
19012
19610
  });
19013
19611
  }