新增

- 【帐号】退出登录 - 【飞书人事（企业版）】查询编制规划方案 - 【飞书人事（企业版）】启用/停用公司 - 【飞书人事（企业版）】添加地点地址 - 【飞书人事（企业版）】更新地点地址 - 【飞书人事（企业版）】启用/停用地点 - 【飞书人事（企业版）】更新地点 - 【飞书人事（企业版）】删除地点地址变更 - 发起员工异动请求体 - 发起员工异动响应体 - 获取招聘需求列表响应体 - 创建招聘需求请求体 - 创建招聘需求响应体 - 获取招聘需求信息响应体 - 更新招聘需求请求体 - 第三方会议室日程变动事件体 - 【飞书人事（企业版）】获取指定人员审批任务列表接口 Signed-off-by: Vicente.Yu <^@^>
vicenteyu · Nov 3, 2024 · 788ccd9 · 788ccd9
1 parent cf4b1b2
commit 788ccd9
Show file tree

Hide file tree

Showing 96 changed files with 3,280 additions and 1,108 deletions.
diff --git a/TenantAccessList.md b/TenantAccessList.md
diff --git a/UserAccessList.md b/UserAccessList.md
diff --git a/src/Attendance/PostAttendanceV1UserApprovalsBodyDto.cs b/src/Attendance/PostAttendanceV1UserApprovalsBodyDto.cs
@@ -310,7 +310,7 @@ public record UserLeaveI18nNames
         public record UserOvertimeWork
         {
             /// <summary>
-            /// <para>加班时长</para>
+            /// <para>加班时长，如需使用此字段进行加班时长计算，请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)开通。默认采用start_time和end_time计算</para>
             /// <para>必填：是</para>
             /// <para>示例值：1.5</para>
             /// </summary>

diff --git a/src/Auth.Spec/PostAuthV3TenantAccessTokenInternalBodyDto.cs b/src/Auth.Spec/PostAuthV3TenantAccessTokenInternalBodyDto.cs
@@ -15,9 +15,10 @@ namespace FeishuNetSdk.Auth.Spec;
 /// <summary>
 /// 自建应用获取 tenant_access_token 请求体
 /// <para>自建应用通过此接口获取 `tenant_access_token`。</para>
-/// <para>**说明：** `tenant_access_token` 的最大有效期是 2 小时。</para>
-/// <para>- 如果在有效期小于 30 分钟的情况下，调用本接口，会返回一个新的 `tenant_access_token`，这会同时存在两个有效的 `tenant_access_token`。</para>
-/// <para>- 如果有效期不小于 30 分钟，调用本接口，会返回原有的 `tenant_access_token`。</para>
+/// <para>注意事项：</para>
+/// <para>`tenant_access_token` 的最大有效期是 2 小时。</para>
+/// <para>- 剩余有效期小于 30 分钟时，调用本接口会返回一个新的 `tenant_access_token`，这会同时存在两个有效的 `tenant_access_token`。</para>
+/// <para>- 剩余有效期大于等于 30 分钟时，调用本接口会返回原有的 `tenant_access_token`。</para>
 /// <para>接口ID：6995779366223724548</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/authentication-management/access-token/tenant_access_token_internal</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fukDNz4SO0MjL5QzM%2fauth-v3%2fauth%2ftenant_access_token_internal</para>

diff --git a/src/Auth.Spec/PostAuthV3TenantAccessTokenInternalResponseDto.cs b/src/Auth.Spec/PostAuthV3TenantAccessTokenInternalResponseDto.cs
@@ -15,9 +15,10 @@ namespace FeishuNetSdk.Auth.Spec;
 /// <summary>
 /// 自建应用获取 tenant_access_token 响应体
 /// <para>自建应用通过此接口获取 `tenant_access_token`。</para>
-/// <para>**说明：** `tenant_access_token` 的最大有效期是 2 小时。</para>
-/// <para>- 如果在有效期小于 30 分钟的情况下，调用本接口，会返回一个新的 `tenant_access_token`，这会同时存在两个有效的 `tenant_access_token`。</para>
-/// <para>- 如果有效期不小于 30 分钟，调用本接口，会返回原有的 `tenant_access_token`。</para>
+/// <para>注意事项：</para>
+/// <para>`tenant_access_token` 的最大有效期是 2 小时。</para>
+/// <para>- 剩余有效期小于 30 分钟时，调用本接口会返回一个新的 `tenant_access_token`，这会同时存在两个有效的 `tenant_access_token`。</para>
+/// <para>- 剩余有效期大于等于 30 分钟时，调用本接口会返回原有的 `tenant_access_token`。</para>
 /// <para>接口ID：6995779366223724548</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/authentication-management/access-token/tenant_access_token_internal</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fukTMukTMukTM%2fukDNz4SO0MjL5QzM%2fauth-v3%2fauth%2ftenant_access_token_internal</para>

diff --git a/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdResponseDto.cs b/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdResponseDto.cs
@@ -9,12 +9,12 @@
 // <copyright file="GetBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdResponseDto.cs" company="Vicente Yu">
 //     MIT
 // </copyright>
-// <summary>检索视图 响应体</summary>
+// <summary>获取视图 响应体</summary>
 // ************************************************************************
 namespace FeishuNetSdk.Base;
 /// <summary>
-/// 检索视图 响应体
-/// <para>该接口根据 view_id 检索现有视图</para>
+/// 获取视图 响应体
+/// <para>根据视图 ID 获取现有视图信息，包括视图名称、类型、属性等。</para>
 /// <para>接口ID：7177650713441845251</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/get</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-table-view%2fget</para>
@@ -34,23 +34,29 @@ public record GetBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdResponseDto
     public record AppTableView
     {
         /// <summary>
-        /// <para>视图Id</para>
+        /// <para>视图 ID</para>
         /// <para>必填：否</para>
         /// <para>示例值：vewieWxfON</para>
         /// </summary>
         [JsonPropertyName("view_id")]
         public string? ViewId { get; set; }
 
         /// <summary>
-        /// <para>视图名字</para>
+        /// <para>视图名称</para>
         /// <para>必填：否</para>
         /// <para>示例值：表格 1</para>
         /// </summary>
         [JsonPropertyName("view_name")]
         public string? ViewName { get; set; }
 
         /// <summary>
-        /// <para>视图类型</para>
+        /// <para>视图类型。</para>
+        /// <para>**可选值有**：</para>
+        /// <para>- `grid`：表格视图</para>
+        /// <para>- `kanban`：看板视图</para>
+        /// <para>- `gallery`：画册视图</para>
+        /// <para>- `gantt`：甘特视图</para>
+        /// <para>- `form`：表单视图</para>
         /// <para>必填：否</para>
         /// <para>示例值：grid</para>
         /// </summary>
@@ -145,7 +151,7 @@ public record AppTableViewPropertyFilterInfoCondition
                     public string? Value { get; set; }
 
                     /// <summary>
-                    /// <para>过滤条件的唯一ID</para>
+                    /// <para>过滤条件的 ID</para>
                     /// <para>必填：否</para>
                     /// <para>示例值：conNaOEK6O</para>
                     /// </summary>
@@ -192,7 +198,7 @@ public record AppTableViewPropertyFilterInfoCondition
             }
 
             /// <summary>
-            /// <para>隐藏字段ID列表</para>
+            /// <para>隐藏字段 ID 列表</para>
             /// <para>必填：否</para>
             /// <para>示例值：["fldCGzANXx", "fldCGzANXx"]</para>
             /// <para>最大长度：300</para>
@@ -213,7 +219,7 @@ public record AppTableViewPropertyFilterInfoCondition
             public record AppTableViewPropertyHierarchyConfig
             {
                 /// <summary>
-                /// <para>层级结构的关联列id</para>
+                /// <para>层级结构的关联列 ID</para>
                 /// <para>必填：否</para>
                 /// <para>示例值：fldTca**hb</para>
                 /// </summary>

diff --git a/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdViewsResponseDto.cs b/src/Base/GetBitableV1AppsByAppTokenTablesByTableIdViewsResponseDto.cs
@@ -14,7 +14,7 @@
 namespace FeishuNetSdk.Base;
 /// <summary>
 /// 列出视图 响应体
-/// <para>根据 app_token 和 table_id，获取数据表的所有视图</para>
+/// <para>获取多维表格数据表中的所有视图。</para>
 /// <para>接口ID：6978670625209597954</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/list</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-table-view%2flist</para>
@@ -34,31 +34,37 @@ public record GetBitableV1AppsByAppTokenTablesByTableIdViewsResponseDto
     public record AppTableView
     {
         /// <summary>
-        /// <para>视图Id</para>
+        /// <para>视图 ID</para>
         /// <para>必填：否</para>
         /// <para>示例值：vewieWxfON</para>
         /// </summary>
         [JsonPropertyName("view_id")]
         public string? ViewId { get; set; }
 
         /// <summary>
-        /// <para>视图名字</para>
+        /// <para>视图名称</para>
         /// <para>必填：否</para>
-        /// <para>示例值：表格1</para>
+        /// <para>示例值：表格 1</para>
         /// </summary>
         [JsonPropertyName("view_name")]
         public string? ViewName { get; set; }
 
         /// <summary>
-        /// <para>视图类型</para>
+        /// <para>视图类型。</para>
+        /// <para>**可选值有**：</para>
+        /// <para>- `grid`：表格视图</para>
+        /// <para>- `kanban`：看板视图</para>
+        /// <para>- `gallery`：画册视图</para>
+        /// <para>- `gantt`：甘特视图</para>
+        /// <para>- `form`：表单视图</para>
         /// <para>必填：否</para>
         /// <para>示例值：grid</para>
         /// </summary>
         [JsonPropertyName("view_type")]
         public string? ViewType { get; set; }
 
         /// <summary>
-        /// <para>视图公共等级 Public、Locked、Private</para>
+        /// <para>视图公共等级</para>
         /// <para>必填：否</para>
         /// <para>示例值：Public</para>
         /// <para>可选值：<list type="bullet">
@@ -71,7 +77,7 @@ public record AppTableView
         public string? ViewPublicLevel { get; set; }
 
         /// <summary>
-        /// <para>个人视图的owner_id，id类型和 user_id_type 参数保持一致</para>
+        /// <para>个人视图的所有者的 ID，ID 类型和查询参数 user_id_type 保持一致</para>
         /// <para>必填：否</para>
         /// <para>示例值：ou_2910013f1e6456f16a0ce75ede950a0a</para>
         /// </summary>

diff --git a/src/Base/GetBitableV1AppsByAppTokenTablesResponseDto.cs b/src/Base/GetBitableV1AppsByAppTokenTablesResponseDto.cs
@@ -14,7 +14,7 @@
 namespace FeishuNetSdk.Base;
 /// <summary>
 /// 列出数据表 响应体
-/// <para>根据 app_token，获取多维表格下的所有数据表。</para>
+/// <para>列出多维表格中的所有数据表，包括其 ID、版本号和名称。</para>
 /// <para>接口ID：6960166873968476163</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/list</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-table%2flist</para>
@@ -58,23 +58,23 @@ public record GetBitableV1AppsByAppTokenTablesResponseDto
     public record AppTable
     {
         /// <summary>
-        /// <para>数据表 id</para>
+        /// <para>数据表 ID</para>
         /// <para>必填：否</para>
         /// <para>示例值：\-</para>
         /// </summary>
         [JsonPropertyName("table_id")]
         public string? TableId { get; set; }
 
         /// <summary>
-        /// <para>数据表的版本号</para>
+        /// <para>数据表的版本号。对数据表进行修改时更新，如新增、删除记录，修改数据表名称等，初始为 1，每次更新+1</para>
         /// <para>必填：否</para>
         /// <para>示例值：\-</para>
         /// </summary>
         [JsonPropertyName("revision")]
         public int? Revision { get; set; }
 
         /// <summary>
-        /// <para>数据表名字</para>
+        /// <para>数据表名称</para>
         /// <para>必填：否</para>
         /// <para>示例值：\-</para>
         /// </summary>

diff --git a/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdBodyDto.cs b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdBodyDto.cs
@@ -14,9 +14,7 @@
 namespace FeishuNetSdk.Base;
 /// <summary>
 /// 更新数据表 请求体
-/// <para>该接口用于更新数据表的基本信息，包括数据表的名称等。</para>
-/// <para>note</para>
-/// <para>首次调用请参考 [云文档接口快速入门](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)[多维表格接口接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification)</para>
+/// <para>更新数据表的名称。</para>
 /// <para>接口ID：7182466310810402817</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/patch</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-table%2fpatch</para>
@@ -25,11 +23,11 @@ public record PatchBitableV1AppsByAppTokenTablesByTableIdBodyDto
 {
     /// <summary>
     /// <para>数据表的新名称。</para>
-    /// <para>请注意：</para>
-    /// <para>1. 名称中的首尾空格将会被去除。</para>
-    /// <para>2. 如果名称为空或和旧名称相同，接口仍然会返回成功，但是名称不会被更改。</para>
+    /// <para>**注意**：</para>
+    /// <para>- 名称中的首尾空格将会被去除。</para>
+    /// <para>- 如果名称为空或和旧名称相同，接口仍然会返回成功，但是名称不会被更改。</para>
     /// <para>必填：否</para>
-    /// <para>示例值：数据表的新名称</para>
+    /// <para>示例值：新的数据表名称</para>
     /// <para>最大长度：100</para>
     /// <para>最小长度：1</para>
     /// </summary>

diff --git a/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdResponseDto.cs b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdResponseDto.cs
@@ -14,19 +14,17 @@
 namespace FeishuNetSdk.Base;
 /// <summary>
 /// 更新数据表 响应体
-/// <para>该接口用于更新数据表的基本信息，包括数据表的名称等。</para>
-/// <para>note</para>
-/// <para>首次调用请参考 [云文档接口快速入门](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)[多维表格接口接入指南](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/bitable/notification)</para>
+/// <para>更新数据表的名称。</para>
 /// <para>接口ID：7182466310810402817</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table/patch</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-table%2fpatch</para>
 /// </summary>
 public record PatchBitableV1AppsByAppTokenTablesByTableIdResponseDto
 {
     /// <summary>
-    /// <para>数据表的名称</para>
+    /// <para>新的数据表名称</para>
     /// <para>必填：否</para>
-    /// <para>示例值：数据表的新名称</para>
+    /// <para>示例值：新的数据表名称</para>
     /// </summary>
     [JsonPropertyName("name")]
     public string? Name { get; set; }

diff --git a/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdBodyDto.cs b/src/Base/PatchBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdBodyDto.cs
@@ -14,7 +14,7 @@
 namespace FeishuNetSdk.Base;
 /// <summary>
 /// 更新视图 请求体
-/// <para>该接口用于增量修改视图信息</para>
+/// <para>增量更新视图信息，包括视图名称、属性等，可设置视图的筛选条件等。</para>
 /// <para>接口ID：7177650713441828867</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-view/patch</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fbitable-v1%2fapp-table-view%2fpatch</para>
@@ -24,7 +24,7 @@ public record PatchBitableV1AppsByAppTokenTablesByTableIdViewsByViewIdBodyDto
     /// <summary>
     /// <para>视图名称</para>
     /// <para>必填：否</para>
-    /// <para>示例值：grid</para>
+    /// <para>示例值：表格视图 1</para>
     /// </summary>
     [JsonPropertyName("view_name")]
     public string? ViewName { get; set; }
@@ -54,7 +54,7 @@ public record AppTableViewProperty
         public record AppTableViewPropertyFilterInfo
         {
             /// <summary>
-            /// <para>多个筛选条件的关系</para>
+            /// <para>多个筛选条件的关系，表示条件之间的逻辑连接词</para>
             /// <para>必填：是</para>
             /// <para>示例值：and</para>
             /// <para>可选值：<list type="bullet">
@@ -67,28 +67,28 @@ public record AppTableViewPropertyFilterInfo
             public string Conjunction { get; set; } = string.Empty;
 
             /// <summary>
-            /// <para>筛选条件</para>
+            /// <para>筛选条件集合</para>
             /// <para>必填：是</para>
             /// <para>最大长度：50</para>
             /// </summary>
             [JsonPropertyName("conditions")]
             public AppTableViewPropertyFilterInfoCondition[] Conditions { get; set; } = Array.Empty<AppTableViewPropertyFilterInfoCondition>();
 
             /// <summary>
-            /// <para>筛选条件</para>
+            /// <para>筛选条件集合</para>
             /// </summary>
             public record AppTableViewPropertyFilterInfoCondition
             {
                 /// <summary>
-                /// <para>用于过滤的字段唯一ID</para>
+                /// <para>用于过滤的字段的 ID。可通过[列出字段](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-field/list)接口获取</para>
                 /// <para>必填：是</para>
-                /// <para>示例值：fldVioU**1</para>
+                /// <para>示例值：fldmeqmpVA</para>
                 /// </summary>
                 [JsonPropertyName("field_id")]
                 public string FieldId { get; set; } = string.Empty;
 
                 /// <summary>
-                /// <para>过滤操作的类型</para>
+                /// <para>过滤操作的类型，条件运算符</para>
                 /// <para>必填：是</para>
                 /// <para>示例值：is</para>
                 /// <para>可选值：<list type="bullet">
@@ -109,19 +109,19 @@ public record AppTableViewPropertyFilterInfoCondition
                 public string Operator { get; set; } = string.Empty;
 
                 /// <summary>
-                /// <para>筛选值</para>
+                /// <para>条件的值，可以是单个值或多个值的数组。不同字段类型和不同的 operator 可填的值不同。详情参考下文字段目标值（value）填写说明。</para>
                 /// <para>必填：否</para>
-                /// <para>示例值：["optbdVH***","optrpd3***"]</para>
+                /// <para>示例值：`[\"text content\"]`</para>
                 /// </summary>
                 [JsonPropertyName("value")]
                 public string? Value { get; set; }
             }
         }
 
         /// <summary>
-        /// <para>隐藏字段ID列表</para>
+        /// <para>隐藏字段 ID 列表</para>
         /// <para>必填：否</para>
-        /// <para>示例值：["fldCGzANXx","fldCGzANXx"]</para>
+        /// <para>示例值：["fldCGzANXx", "fldCGzANXx"]</para>
         /// <para>最大长度：300</para>
         /// </summary>
         [JsonPropertyName("hidden_fields")]
@@ -140,9 +140,9 @@ public record AppTableViewPropertyFilterInfoCondition
         public record AppTableViewPropertyHierarchyConfig
         {
             /// <summary>
-            /// <para>层级结构的关联列id</para>
+            /// <para>层级结构的关联列 ID</para>
             /// <para>必填：否</para>
-            /// <para>示例值：fldTca**hb</para>
+            /// <para>示例值：fldmeqmpVA</para>
             /// </summary>
             [JsonPropertyName("field_id")]
             public string? FieldId { get; set; }