@larksuiteoapi/node-sdk 1.4.0 → 1.5.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/README.md CHANGED
@@ -430,19 +430,26 @@ router.post(
430
430
  ```
431
431
 
432
432
  ### [Message Card](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)
433
+
433
434
  The processing of the Message Card is also a kind of Event processing. The only difference between the two is that the processor of the Message Card is used to respond to the events generated by the interaction between the user and the Message Card. If the processor has a return value (*the value structure should be in line with the structure defined by [Message Card Structure](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)*), then the return value is used to update the responded message card:
434
435
 
435
436
  ```typescript
436
437
  import http from 'http';
437
438
  import * as lark from '@larksuiteoapi/node-sdk';
439
+ import type { InteractiveCardActionEvent, InteractiveCard } from '@larksuiteoapi/node-sdk';
438
440
 
439
441
  const cardDispatcher = new lark.CardActionHandler(
440
442
  {
441
443
  encryptKey: 'encrypt key',
442
444
  verificationToken: 'verification token'
443
445
  },
444
- async(data) => {
446
+ async (data: InteractiveCardActionEvent) => {
445
447
  console.log(data);
448
+ const newCard: InteractiveCard = {
449
+ // your new interactive card content
450
+ header: {},
451
+ elements: []
452
+ };
446
453
  return newCard;
447
454
  }
448
455
  );
@@ -451,6 +458,7 @@ const server = http.createServer();
451
458
  server.on('request', lark.adaptDefault('/webhook/card', cardDispatcher));
452
459
  server.listen(3000);
453
460
  ````
461
+
454
462
  #### `CardActionHandler` construction parameters
455
463
 
456
464
  | Parameter | Description | Type | Required | Default |
@@ -470,6 +478,9 @@ import * as lark from '@larksuiteoapi/node-sdk';
470
478
  new lark.AESCipher('encrypt key').decrypt('content');
471
479
  ````
472
480
 
481
+ ## Examples
482
+ [Rapidly develop auto-responder bot](https://github.com/larksuite/lark-samples/blob/main/react_and_nodejs/robot/README.zh.md)
483
+
473
484
  ## Blog
474
485
  [ISV Application Development Guide](https://bytedance.feishu.cn/docx/RUZKdGwdyoH4KexMJgDcITQnn0b)
475
486
 
package/README.zh.md CHANGED
@@ -429,19 +429,26 @@ router.post(
429
429
  ```
430
430
 
431
431
  ### [消息卡片](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)
432
+
432
433
  对消息卡片的处理亦是对事件处理的一种,两者的不同点仅在于消息卡片的处理器用于响应用户与消息卡片交互所产生的事件,若处理器有返回值(*返回值的数据结构理应为符合[消息卡片结构](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)所定义的结构*),则返回值被用来更新被响应的消息卡片:
433
434
 
434
435
  ```typescript
435
436
  import http from 'http';
436
437
  import * as lark from '@larksuiteoapi/node-sdk';
438
+ import type { InteractiveCardActionEvent, InteractiveCard } from '@larksuiteoapi/node-sdk';
437
439
 
438
440
  const cardDispatcher = new lark.CardActionHandler(
439
441
  {
440
442
  encryptKey: 'encrypt key',
441
443
  verificationToken: 'verification token'
442
444
  },
443
- async (data) => {
445
+ async (data: InteractiveCardActionEvent) => {
444
446
  console.log(data);
447
+ const newCard: InteractiveCard = {
448
+ // your new interactive card content
449
+ header: {},
450
+ elements: []
451
+ };
445
452
  return newCard;
446
453
  }
447
454
  );
@@ -450,6 +457,7 @@ const server = http.createServer();
450
457
  server.on('request', lark.adaptDefault('/webhook/card', cardDispatcher));
451
458
  server.listen(3000);
452
459
  ```
460
+
453
461
  #### `CardActionHandler`构造参数
454
462
 
455
463
  | 参数 | 描述 | 类型 | 必须 | 默认 |
@@ -469,6 +477,9 @@ import * as lark from '@larksuiteoapi/node-sdk';
469
477
  new lark.AESCipher('encrypt key').decrypt('content');
470
478
  ```
471
479
 
480
+ ## Examples
481
+ [快速开发自动回复机器人](https://github.com/larksuite/lark-samples/blob/main/react_and_nodejs/robot/README.zh.md)
482
+
472
483
  ## Blog
473
484
  [ISV(商店应用)开发指南](https://bytedance.feishu.cn/docx/RUZKdGwdyoH4KexMJgDcITQnn0b)
474
485
 
package/es/index.js CHANGED
@@ -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
  */
@@ -1352,7 +1429,7 @@ class Client$1 {
1352
1429
  */
1353
1430
  this.approval = {
1354
1431
  /**
1355
- * 原生审批定义
1432
+ * 事件
1356
1433
  */
1357
1434
  approval: {
1358
1435
  /**
@@ -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
  /**
@@ -3771,7 +3848,7 @@ class Client$1 {
3771
3848
  },
3772
3849
  };
3773
3850
  /**
3774
- * 云文档-多维表格
3851
+ * 云文档-电子表格
3775
3852
  */
3776
3853
  this.bitable = {
3777
3854
  /**
@@ -6035,7 +6112,7 @@ class Client$1 {
6035
6112
  *
6036
6113
  * 该接口用于以当前身份(应用 / 用户)获取日历下的日程列表。;身份由 Header Authorization 的 Token 类型决定。
6037
6114
  *
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,否则可能造成日程数据缺失。
6115
+ * - 当前身份必须对日历有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
6116
  */
6040
6117
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
6041
6118
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8610,9 +8687,9 @@ class Client$1 {
8610
8687
  *
8611
8688
  * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file-comment/list document }
8612
8689
  *
8613
- * 获取文档评论
8690
+ * 分页获取文档评论
8614
8691
  *
8615
- * 根据文档token分页获取云文档中的评论。
8692
+ * 该接口用于根据文档 token 分页获取文档评论。
8616
8693
  */
8617
8694
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
8618
8695
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -8708,7 +8785,7 @@ class Client$1 {
8708
8785
  }),
8709
8786
  },
8710
8787
  /**
8711
- * 下载
8788
+ * 文件夹
8712
8789
  */
8713
8790
  file: {
8714
8791
  /**
@@ -9247,7 +9324,7 @@ class Client$1 {
9247
9324
  }),
9248
9325
  },
9249
9326
  /**
9250
- * 素材
9327
+ * 分片上传
9251
9328
  */
9252
9329
  media: {
9253
9330
  /**
@@ -12243,7 +12320,7 @@ class Client$1 {
12243
12320
  *
12244
12321
  * 获取会话中的群公告信息,公告信息格式与[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。
12245
12322
  *
12246
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app)
12323
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 获取内部群信息时,操作者须与群组在同一租户下
12247
12324
  */
12248
12325
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12249
12326
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12269,7 +12346,7 @@ class Client$1 {
12269
12346
  *
12270
12347
  * 更新会话中的群公告信息,更新公告信息的格式和更新[云文档](https://open.feishu.cn/document/ukTMukTMukTM/uAzM5YjLwMTO24CMzkjN)格式相同。
12271
12348
  *
12272
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置,群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置,所有成员可以更新群公告
12349
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 操作者需要拥有群公告文档的阅读权限;- 获取内部群信息时,操作者须与群组在同一租户下;- 若群开启了 ==仅群主和群管理员可编辑群信息== 配置,群主/群管理员 或 创建群组且具备 ==更新应用所创建群的群信息== 权限的机器人,可更新群公告;- 若群未开启 ==仅群主和群管理员可编辑群信息== 配置,所有成员可以更新群公告
12273
12350
  */
12274
12351
  patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12275
12352
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12452,7 +12529,7 @@ class Client$1 {
12452
12529
  *
12453
12530
  * 获取用户或者机器人所在群列表。
12454
12531
  *
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单聊群
12532
+ * 注意事项:; - 应用需要开启[机器人能力](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
12533
  */
12457
12534
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12458
12535
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12583,7 +12660,7 @@ class Client$1 {
12583
12660
  *
12584
12661
  * 将用户或机器人指定为群管理员。
12585
12662
  *
12586
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以指定群管理员;- 对于普通群,最多指定 10 个管理员;- 对于超大群,最多指定 20 个管理员;- 每次请求最多指定 50 个用户或者 5 个机器人;- 指定机器人类型的管理员请使用 ==app_id==
12663
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以指定群管理员
12587
12664
  */
12588
12665
  addManagers: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12589
12666
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12609,7 +12686,7 @@ class Client$1 {
12609
12686
  *
12610
12687
  * 删除指定的群管理员(用户或机器人)。
12611
12688
  *
12612
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以删除群管理员;- 每次请求最多指定 50 个用户或者 5 个机器人;- 删除机器人类型的管理员请使用 ==app_id==
12689
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 仅有群主可以删除群管理员
12613
12690
  */
12614
12691
  deleteManagers: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12615
12692
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12666,7 +12743,7 @@ class Client$1 {
12666
12743
  *
12667
12744
  * 将用户或机器人移出群聊。
12668
12745
  *
12669
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 用户或机器人在任何条件下均可移除自己出群(即主动退群);- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人,可以移除其他用户或者机器人; - 每次请求,最多移除50个用户或者5个机器人
12746
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 用户或机器人在任何条件下均可移除自己出群(即主动退群);- 仅有群主/管理员 或 创建群组并且具备 ==更新应用所创建群的群信息== 权限的机器人,可以移除其他用户或者机器人;- 每次请求,最多移除50个用户或者5个机器人;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12670
12747
  */
12671
12748
  delete: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12672
12749
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12738,9 +12815,9 @@ class Client$1 {
12738
12815
  *
12739
12816
  * 获取群成员列表
12740
12817
  *
12741
- * 如果用户在群中,则返回该群的成员列表。
12818
+ * 获取用户/机器人所在群的群成员列表。
12742
12819
  *
12743
- * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员,因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员,会一次性返回,这会导致返回的群成员个数可能会大于指定的page_size
12820
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 机器人或授权用户必须在群组中; - 该接口不会返回群内的机器人成员; - 由于返回的群成员列表会过滤掉机器人成员,因此返回的群成员个数可能会小于指定的page_size; - 如果有同一时间加入群的群成员,会一次性返回,这会导致返回的群成员个数可能会大于指定的page_size;- 获取内部群信息时,操作者须与群组在同一租户下;- 获取外部群信息时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12744
12821
  */
12745
12822
  get: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12746
12823
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12765,6 +12842,8 @@ class Client$1 {
12765
12842
  * 判断用户或机器人是否在群里
12766
12843
  *
12767
12844
  * 根据使用的access_token判断对应的用户或者机器人是否在群里。
12845
+ *
12846
+ * 注意事项:; - 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 获取内部群信息时,操作者须与群组在同一租户下;- 获取外部群信息时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12768
12847
  */
12769
12848
  isInChat: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12770
12849
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12790,7 +12869,7 @@ class Client$1 {
12790
12869
  *
12791
12870
  * 用户或机器人主动加入群聊。
12792
12871
  *
12793
- * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app); - 目前仅支持加入公开群
12872
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 目前仅支持加入公开群;- 操作内部群时,操作者须与群组在同一租户下
12794
12873
  */
12795
12874
  meJoin: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12796
12875
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12924,9 +13003,9 @@ class Client$1 {
12924
13003
  *
12925
13004
  * 添加会话标签页
12926
13005
  *
12927
- * 添加自定义会话标签页
13006
+ * 添加自定义会话标签页。
12928
13007
  *
12929
- * 注意事项:;;- 只允许添加类型为doc和url的会话标签页;;- 创建时不需要设置tabID;;- 一个群内最多只允许添加20个自定义会话标签页;;- 会话标签页的名称不超过30个字符;;- 添加doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限
13008
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 不需要填写请求体中的`tab_id`字段;- 只允许添加类型为`doc`和`url`的会话标签页;- 添加doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12930
13009
  */
12931
13010
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12932
13011
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12950,7 +13029,9 @@ class Client$1 {
12950
13029
  *
12951
13030
  * 删除会话标签页
12952
13031
  *
12953
- * 删除会话标签页
13032
+ * 删除会话标签页。
13033
+ *
13034
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许删除类型为`doc`和`url`的会话标签页;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12954
13035
  */
12955
13036
  deleteTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12956
13037
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12974,7 +13055,9 @@ class Client$1 {
12974
13055
  *
12975
13056
  * 拉取会话标签页
12976
13057
  *
12977
- * 拉取会话标签页
13058
+ * 拉取会话标签页。
13059
+ *
13060
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
12978
13061
  */
12979
13062
  listTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
12980
13063
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -12998,9 +13081,9 @@ class Client$1 {
12998
13081
  *
12999
13082
  * 会话标签页排序
13000
13083
  *
13001
- * 会话标签页排序
13084
+ * 会话标签页排序。
13002
13085
  *
13003
- * 注意事项:;;- 当前消息标签页固定为第一顺位,不参与排序,但是请求体中必须包含。;;- 请求体必须包含全部的TabID
13086
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 消息标签页强制固定为第一顺位,不参与排序,但是请求体中必须包含该标签页的Tab ID;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
13004
13087
  */
13005
13088
  sortTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13006
13089
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13026,7 +13109,7 @@ class Client$1 {
13026
13109
  *
13027
13110
  * 更新会话标签页
13028
13111
  *
13029
- * 注意事项:;;- 只允许更新类型为docurl的会话标签页;;- 会话标签页的名称不超过30个字符;;- 更新doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限
13112
+ * 注意事项:;- 应用需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app);- 机器人或授权用户必须在群里;- 只允许更新类型为`doc`和`url`的会话标签页;- 更新doc类型时,操作者(access token对应的身份)需要拥有对应文档的权限;- 操作内部群时,操作者须与群组在同一租户下;- 操作外部群时,请先在[开发者后台](https://open.feishu.cn/app)—权限管理—权限配置页面申请 ==在外部群调用群聊的 API 及事件== 权限
13030
13113
  */
13031
13114
  updateTabs: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13032
13115
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13248,7 +13331,7 @@ class Client$1 {
13248
13331
  }),
13249
13332
  },
13250
13333
  /**
13251
- * 消息 - 消息卡片
13334
+ * 消息
13252
13335
  */
13253
13336
  message: {
13254
13337
  /**
@@ -13388,7 +13471,7 @@ class Client$1 {
13388
13471
  *
13389
13472
  * - 需要开启[机器人能力](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app) ;- 获取消息时,机器人必须在群组中
13390
13473
  *
13391
- * 接口级别权限默认只能获取单聊(p2p)消息,如果需要获取群组(group)消息,应用还必须拥有 ***获取群组中所有消息*** 权限
13474
+ * 接口级别权限默认只能获取单聊(p2p)消息,如果需要获取群组(group)消息,应用还必须拥有 **==获取群组中所有消息==** 权限
13392
13475
  */
13393
13476
  list: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13394
13477
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -13414,7 +13497,7 @@ class Client$1 {
13414
13497
  *
13415
13498
  * 更新应用已发送的消息卡片内容。
13416
13499
  *
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**
13500
+ * 注意事项:;- 需要开启[机器人能力](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
13501
  */
13419
13502
  patch: (payload, options) => __awaiter(this, void 0, void 0, function* () {
13420
13503
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -15790,7 +15873,7 @@ class Client$1 {
15790
15873
  *
15791
15874
  * 创建表格
15792
15875
  *
15793
- * 使用该接口可以在指定的目录下创建在线表格。
15876
+ * 在指定目录下创建表格
15794
15877
  */
15795
15878
  create: (payload, options) => __awaiter(this, void 0, void 0, function* () {
15796
15879
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -16224,7 +16307,7 @@ class Client$1 {
16224
16307
  }),
16225
16308
  },
16226
16309
  /**
16227
- * 行列
16310
+ * 单元格
16228
16311
  */
16229
16312
  spreadsheetSheet: {
16230
16313
  /**
@@ -16234,7 +16317,7 @@ class Client$1 {
16234
16317
  *
16235
16318
  * 查找单元格
16236
16319
  *
16237
- * 按照指定的条件查找子表的某个范围内的数据符合条件的单元格位置。请求体中的 range 和 find 字段为必填。
16320
+ * 在指定范围内查找符合查找条件的单元格。
16238
16321
  */
16239
16322
  find: (payload, options) => __awaiter(this, void 0, void 0, function* () {
16240
16323
  const { headers, params, data, path } = yield this.formatPayload(payload, options);
@@ -17696,6 +17779,30 @@ class Client$1 {
17696
17779
  throw e;
17697
17780
  });
17698
17781
  }),
17782
+ /**
17783
+ * {@link https://open.feishu.cn/api-explorer?project=vc&resource=export&apiName=resource_reservation_list&version=v1 click to debug }
17784
+ *
17785
+ * {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/vc-v1/export/resource_reservation_list document }
17786
+ *
17787
+ * 导出会议室预定数据
17788
+ *
17789
+ * 导出会议室预定数据,具体权限要求请参考「导出概述」
17790
+ */
17791
+ resourceReservationList: (payload, options) => __awaiter(this, void 0, void 0, function* () {
17792
+ const { headers, params, data, path } = yield this.formatPayload(payload, options);
17793
+ return httpInstance
17794
+ .request({
17795
+ url: fillApiPath(`${this.domain}/open-apis/vc/v1/exports/resource_reservation_list`, path),
17796
+ method: "POST",
17797
+ data,
17798
+ params,
17799
+ headers,
17800
+ })
17801
+ .catch((e) => {
17802
+ this.logger.error(formatErrors(e));
17803
+ throw e;
17804
+ });
17805
+ }),
17699
17806
  },
17700
17807
  /**
17701
17808
  * 会议
@@ -18204,7 +18311,7 @@ class Client$1 {
18204
18311
  }),
18205
18312
  },
18206
18313
  /**
18207
- * 会议室预定范围
18314
+ * reserve_config
18208
18315
  */
18209
18316
  reserveConfig: {
18210
18317
  /**