新增

- 【招聘】新建招聘官网用户
- 【招聘】获取招聘官网列表
- 【招聘】职位发布至官网
- 【飞书人事（企业版）】发起转正
- 【飞书人事（企业版）】撤销转正
- 【日历】创建会议纪要
- 【飞书人事（企业版）】操作员工完成入职
- 【飞书人事（企业版）】流转入职任务
- 【飞书人事（企业版）】查询待入职信息

变更
- 查询打卡流水 响应体
- 批量查询打卡流水 响应体
- 查询打卡结果 响应体
- 修改保护范围 请求体
- 修改保护范围 响应体
- 更新下拉列表设置 响应体
- 搜索员工异动信息 响应体
- 发起员工异动 请求体
- 发起员工异动 响应体
- 【云文档】增加保护范围
- 【云文档】更新工作表属性
- 【云文档】操作工作表
- 【云文档】设置下拉列表

不推荐使用：
- 【飞书人事】批量查询待入职信息
- 【飞书人事】查询单个待入职信息

Signed-off-by: Vicente.Yu <^@^>

src/Ai.Spec/PostOpticalCharRecognitionV1ImageBasicRecognizeBodyDto.cs → src/Ai/PostOpticalCharRecognitionV1ImageBasicRecognizeBodyDto.cs

@@ -11,7 +11,7 @@
 // </copyright>
 // <summary>识别图片中的文字 请求体</summary>
 // ************************************************************************
-namespace FeishuNetSdk.Ai.Spec;
+namespace FeishuNetSdk.Ai;
 /// <summary>
 /// 识别图片中的文字 请求体
 /// <para>可识别图片中的文字，按图片中的区域划分，分段返回文本列表。</para>
@@ -23,8 +23,8 @@ public record PostOpticalCharRecognitionV1ImageBasicRecognizeBodyDto
 {
     /// <summary>
     /// <para>base64 后的图片数据</para>
-    /// <para>**示例值**："base64后的图片二进制数据"</para>
     /// <para>必填：否</para>
+    /// <para>示例值：base64后的图片二进制数据</para>
     /// </summary>
     [JsonPropertyName("image")]
     public string? Image { get; set; }

src/Ai.Spec/PostOpticalCharRecognitionV1ImageBasicRecognizeResponseDto.cs → src/Ai/PostOpticalCharRecognitionV1ImageBasicRecognizeResponseDto.cs

@@ -11,7 +11,7 @@
 // </copyright>
 // <summary>识别图片中的文字 响应体</summary>
 // ************************************************************************
-namespace FeishuNetSdk.Ai.Spec;
+namespace FeishuNetSdk.Ai;
 /// <summary>
 /// 识别图片中的文字 响应体
 /// <para>可识别图片中的文字，按图片中的区域划分，分段返回文本列表。</para>
@@ -23,8 +23,8 @@ public record PostOpticalCharRecognitionV1ImageBasicRecognizeResponseDto
 {
     /// <summary>
     /// <para>按区域识别，返回文本列表</para>
-    /// <para>必填：否</para>
+    /// <para>必填：是</para>
     /// </summary>
     [JsonPropertyName("text_list")]
-    public string[]? TextList { get; set; }
+    public string[] TextList { get; set; } = Array.Empty<string>();
 }

src/Attendance/GetAttendanceV1UserFlowsByUserFlowIdResponseDto.cs

@@ -4,7 +4,7 @@
 // Created          : 2024-06-24
 //
 // Last Modified By : yxr
-// Last Modified On : 2024-06-24
+// Last Modified On : 2024-07-18
 // ************************************************************************
 // <copyright file="GetAttendanceV1UserFlowsByUserFlowIdResponseDto.cs" company="Vicente Yu">
 //     MIT
@@ -14,23 +14,32 @@
 namespace FeishuNetSdk.Attendance;
 /// <summary>
 /// 查询打卡流水 响应体
-/// <para>通过打卡记录 ID 获取用户的打卡流水记录。</para>
+/// <para>通过打卡记录 ID 获取用户的打卡流水记录。返回信息主要包含：</para>
+/// <para>* 用户id和创建者id</para>
+/// <para>* 记录信息</para>
+/// <para>* 打卡位置信息、时间信息</para>
+/// <para>* 打卡方式信息</para>
+/// <para>* GPS 打卡：location_name（定位地址信息）</para>
+/// <para>* Wi-Fi 打卡：ssid（wifi名称）、bssid（mac地址）</para>
+/// <para>* 考勤机打卡：device_id（考勤机设备id）</para>
+/// <para>* 打卡结果</para>
+/// <para>对应页面功能打卡管理-[打卡记录](https://example.feishu.cn/people/workforce-management/manage/statistics/flow)</para>
 /// <para>接口ID：7044467124773535745</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_task/get</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_flow%2fget</para>
 /// </summary>
 public record GetAttendanceV1UserFlowsByUserFlowIdResponseDto
 {
     /// <summary>
-    /// <para>用户 ID</para>
+    /// <para>用户 ID，对应employee_type</para>
     /// <para>必填：是</para>
     /// <para>示例值：abd754f7</para>
     /// </summary>
     [JsonPropertyName("user_id")]
     public string UserId { get; set; } = string.Empty;
 
     /// <summary>
-    /// <para>记录创建者 ID</para>
+    /// <para>记录创建者 ID，对应employee_type</para>
     /// <para>必填：是</para>
     /// <para>示例值：abd754f7</para>
     /// </summary>
@@ -62,9 +71,9 @@ public record GetAttendanceV1UserFlowsByUserFlowIdResponseDto
     public string Comment { get; set; } = string.Empty;
 
     /// <summary>
-    /// <para>打卡记录 ID</para>
+    /// <para>对应打卡流水记录ID</para>
     /// <para>必填：否</para>
-    /// <para>示例值：考勤内部的打卡记录ID, 6709359313699356941（导入时此参数无效）</para>
+    /// <para>示例值：6709359313699356941</para>
     /// </summary>
     [JsonPropertyName("record_id")]
     public string? RecordId { get; set; }
@@ -102,9 +111,9 @@ public record GetAttendanceV1UserFlowsByUserFlowIdResponseDto
     public bool? IsWifi { get; set; }
 
     /// <summary>
-    /// <para>记录生成方式</para>
+    /// <para>记录生成方式，在开放平台调用时，此参数无效，内部值始终是7</para>
     /// <para>必填：否</para>
-    /// <para>示例值：在开放平台调用时，此参数无效，内部值始终是7</para>
+    /// <para>示例值：7</para>
     /// <para>可选值：<list type="bullet">
     /// <item>0：用户打卡</item>
     /// <item>1：管理员修改</item>
@@ -127,9 +136,9 @@ public record GetAttendanceV1UserFlowsByUserFlowIdResponseDto
     public string[]? PhotoUrls { get; set; }
 
     /// <summary>
-    /// <para>打卡设备ID</para>
+    /// <para>打卡设备ID（只支持小程序打卡，导入时无效）</para>
     /// <para>必填：否</para>
-    /// <para>示例值：（只支持小程序打卡，导入时无效）99e0609ee053448596502691a81428654d7ded64c7bd85acd982d26b3636c37d</para>
+    /// <para>示例值：99e0609ee053448596502691a81428654d7ded64c7bd85acd982d26b3636c37d</para>
     /// </summary>
     [JsonPropertyName("device_id")]
     public string? DeviceId { get; set; }
@@ -161,4 +170,12 @@ public record GetAttendanceV1UserFlowsByUserFlowIdResponseDto
     /// </summary>
     [JsonPropertyName("external_id")]
     public string? ExternalId { get; set; }
+
+    /// <summary>
+    /// <para>唯一幂等键</para>
+    /// <para>必填：否</para>
+    /// <para>示例值：****_***</para>
+    /// </summary>
+    [JsonPropertyName("idempotent_id")]
+    public string? IdempotentId { get; set; }
 }

src/Attendance/GetAttendanceV1UserSettingsQueryBodyDto.cs

@@ -14,15 +14,16 @@
 namespace FeishuNetSdk.Attendance;
 /// <summary>
 /// 批量查询用户人脸识别信息 请求体
-/// <para>批量查询授权内员工的用户设置信息，包括人脸照片文件 ID、人脸照片更新时间。</para>
+/// <para>批量查询授权内员工的用户设置信息，包括人脸照片文件 ID、人脸照片更新时间。对应页面假勤设置-[人脸识别](https://example.feishu.cn/people/workforce-management/setting/group/security)。根据返回的face_key可以下载人脸信息[下载用户人脸识别照片</para>
+/// <para>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/download)</para>
 /// <para>接口ID：7044467124773584897</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_setting/query</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_setting%2fquery</para>
 /// </summary>
 public record GetAttendanceV1UserSettingsQueryBodyDto
 {
     /// <summary>
-    /// <para>employee_no 或 employee_id 列表</para>
+    /// <para>employee_no 或 employee_id 列表，对应employee_type</para>
     /// <para>必填：是</para>
     /// <para>示例值：["abd754f7"]</para>
     /// <para>最大长度：100</para>

src/Attendance/GetAttendanceV1UserSettingsQueryResponseDto.cs

@@ -14,7 +14,8 @@
 namespace FeishuNetSdk.Attendance;
 /// <summary>
 /// 批量查询用户人脸识别信息 响应体
-/// <para>批量查询授权内员工的用户设置信息，包括人脸照片文件 ID、人脸照片更新时间。</para>
+/// <para>批量查询授权内员工的用户设置信息，包括人脸照片文件 ID、人脸照片更新时间。对应页面假勤设置-[人脸识别](https://example.feishu.cn/people/workforce-management/setting/group/security)。根据返回的face_key可以下载人脸信息[下载用户人脸识别照片</para>
+/// <para>](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/download)</para>
 /// <para>接口ID：7044467124773584897</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_setting/query</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_setting%2fquery</para>
@@ -34,15 +35,15 @@ public record GetAttendanceV1UserSettingsQueryResponseDto
     public record UserSetting
     {
         /// <summary>
-        /// <para>用户 ID</para>
+        /// <para>用户 ID，对应employee_type</para>
         /// <para>必填：是</para>
         /// <para>示例值：abd754f7</para>
         /// </summary>
         [JsonPropertyName("user_id")]
         public string UserId { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>人脸照片文件 ID，获取方式：[文件上传](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/upload)</para>
+        /// <para>人脸照片文件 ID，可用于：[下载用户人脸识别照片](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/attendance-v1/file/download)</para>
         /// <para>必填：是</para>
         /// <para>示例值：xxxxxb306842b1c189bc5212eefxxxxx</para>
         /// </summary>

src/Attendance/PostAttendanceV1UserApprovalsQueryBodyDto.cs

@@ -51,8 +51,8 @@ public record PostAttendanceV1UserApprovalsQueryBodyDto
     /// <para>示例值：PeriodTime</para>
     /// <para>可选值：<list type="bullet">
     /// <item>PeriodTime：单据作用时间</item>
-    /// <item>CreateTime：单据创建时间（目前暂不支持）</item>
-    /// <item>UpdateTime：单据状态更新时间</item>
+    /// <item>CreateTime：单据创建时间</item>
+    /// <item>UpdateTime：单据状态更新时间（灰度中，暂不开放）</item>
     /// </list></para>
     /// </summary>
     [JsonPropertyName("check_date_type")]

src/Attendance/PostAttendanceV1UserApprovalsQueryResponseDto.cs

@@ -42,7 +42,7 @@ public record UserApproval
         public string UserId { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>审批作用日期</para>
+        /// <para>审批作用日期，格式yyyyMMdd</para>
         /// <para>必填：是</para>
         /// <para>示例值：20210104</para>
         /// </summary>

src/Attendance/PostAttendanceV1UserFlowsQueryBodyDto.cs

@@ -14,7 +14,16 @@
 namespace FeishuNetSdk.Attendance;
 /// <summary>
 /// 批量查询打卡流水 请求体
-/// <para>批量查询授权内员工的实际打卡流水记录。例如，企业给一个员工设定的班次是上午 9 点和下午 6 点各打一次上下班卡，但是该员工在这期间打了多次卡，该接口会把所有的打卡记录都返回。</para>
+/// <para>通过打卡记录 ID 获取用户的打卡流水记录。返回信息主要包含：</para>
+/// <para>* 用户id和创建者id</para>
+/// <para>* 记录信息</para>
+/// <para>* 打卡位置信息、时间信息</para>
+/// <para>* 打卡方式信息</para>
+/// <para>* GPS 打卡：location_name（定位地址信息）</para>
+/// <para>* Wi-Fi 打卡：ssid（wifi名称）、bssid（mac地址）</para>
+/// <para>* 考勤机打卡：device_id（考勤机设备id）</para>
+/// <para>* 打卡结果</para>
+/// <para>对应页面功能打卡管理-[打卡记录](https://example.feishu.cn/people/workforce-management/manage/statistics/flow)</para>
 /// <para>接口ID：7044467124773617665</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_task/query-2</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_flow%2fquery</para>
@@ -24,21 +33,21 @@ public record PostAttendanceV1UserFlowsQueryBodyDto
     /// <summary>
     /// <para>employee_no 或 employee_id 列表，长度不超过 50</para>
     /// <para>必填：是</para>
-    /// <para>示例值：["abd754f7"]</para>
+    /// <para>示例值：[ "abd754f7"]</para>
     /// </summary>
     [JsonPropertyName("user_ids")]
     public string[] UserIds { get; set; } = Array.Empty<string>();
 
     /// <summary>
-    /// <para>查询的起始时间，时间戳</para>
+    /// <para>查询的起始时间，秒级时间戳</para>
     /// <para>必填：是</para>
     /// <para>示例值：1566641088</para>
     /// </summary>
     [JsonPropertyName("check_time_from")]
     public string CheckTimeFrom { get; set; } = string.Empty;
 
     /// <summary>
-    /// <para>查询的结束时间，时间戳</para>
+    /// <para>查询的结束时间，秒级时间戳</para>
     /// <para>必填：是</para>
     /// <para>示例值：1566641088</para>
     /// </summary>

src/Attendance/PostAttendanceV1UserFlowsQueryResponseDto.cs

@@ -4,7 +4,7 @@
 // Created          : 2024-06-24
 //
 // Last Modified By : yxr
-// Last Modified On : 2024-06-24
+// Last Modified On : 2024-07-18
 // ************************************************************************
 // <copyright file="PostAttendanceV1UserFlowsQueryResponseDto.cs" company="Vicente Yu">
 //     MIT
@@ -14,7 +14,16 @@
 namespace FeishuNetSdk.Attendance;
 /// <summary>
 /// 批量查询打卡流水 响应体
-/// <para>批量查询授权内员工的实际打卡流水记录。例如，企业给一个员工设定的班次是上午 9 点和下午 6 点各打一次上下班卡，但是该员工在这期间打了多次卡，该接口会把所有的打卡记录都返回。</para>
+/// <para>通过打卡记录 ID 获取用户的打卡流水记录。返回信息主要包含：</para>
+/// <para>* 用户id和创建者id</para>
+/// <para>* 记录信息</para>
+/// <para>* 打卡位置信息、时间信息</para>
+/// <para>* 打卡方式信息</para>
+/// <para>* GPS 打卡：location_name（定位地址信息）</para>
+/// <para>* Wi-Fi 打卡：ssid（wifi名称）、bssid（mac地址）</para>
+/// <para>* 考勤机打卡：device_id（考勤机设备id）</para>
+/// <para>* 打卡结果</para>
+/// <para>对应页面功能打卡管理-[打卡记录](https://example.feishu.cn/people/workforce-management/manage/statistics/flow)</para>
 /// <para>接口ID：7044467124773617665</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_task/query-2</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_flow%2fquery</para>
@@ -34,15 +43,15 @@ public record PostAttendanceV1UserFlowsQueryResponseDto
     public record UserFlow
     {
         /// <summary>
-        /// <para>用户 ID</para>
+        /// <para>用户 ID，对应employee_type</para>
         /// <para>必填：是</para>
         /// <para>示例值：abd754f7</para>
         /// </summary>
         [JsonPropertyName("user_id")]
         public string UserId { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>记录创建者 ID</para>
+        /// <para>记录创建者 ID，对应employee_type</para>
         /// <para>必填：是</para>
         /// <para>示例值：abd754f7</para>
         /// </summary>
@@ -58,7 +67,7 @@ public record UserFlow
         public string LocationName { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>打卡时间，精确到秒的时间戳</para>
+        /// <para>打卡时间，秒级时间戳</para>
         /// <para>必填：是</para>
         /// <para>示例值：1611476284</para>
         /// </summary>
@@ -74,7 +83,7 @@ public record UserFlow
         public string Comment { get; set; } = string.Empty;
 
         /// <summary>
-        /// <para>打卡记录 ID</para>
+        /// <para>对应打卡流水记录ID</para>
         /// <para>必填：否</para>
         /// <para>示例值：6709359313699356941</para>
         /// </summary>
@@ -114,7 +123,7 @@ public record UserFlow
         public bool? IsWifi { get; set; }
 
         /// <summary>
-        /// <para>记录生成方式</para>
+        /// <para>记录生成方式，在开放平台调用时，此参数无效，内部值始终是7</para>
         /// <para>必填：否</para>
         /// <para>示例值：7</para>
         /// <para>可选值：<list type="bullet">
@@ -138,6 +147,14 @@ public record UserFlow
         [JsonPropertyName("photo_urls")]
         public string[]? PhotoUrls { get; set; }
 
+        /// <summary>
+        /// <para>打卡设备ID（只支持小程序打卡，导入时无效）</para>
+        /// <para>必填：否</para>
+        /// <para>示例值：99e0609ee053448596502691a81428654d7ded64c7bd85acd982d26b3636c37d</para>
+        /// </summary>
+        [JsonPropertyName("device_id")]
+        public string? DeviceId { get; set; }
+
         /// <summary>
         /// <para>打卡结果，目前仅支持PendingApproval待生效</para>
         /// <para>必填：否</para>
@@ -157,5 +174,21 @@ public record UserFlow
         /// </summary>
         [JsonPropertyName("check_result")]
         public string? CheckResult { get; set; }
+
+        /// <summary>
+        /// <para>用户导入的外部打卡记录ID</para>
+        /// <para>必填：否</para>
+        /// <para>示例值：record_123</para>
+        /// </summary>
+        [JsonPropertyName("external_id")]
+        public string? ExternalId { get; set; }
+
+        /// <summary>
+        /// <para>唯一幂等键</para>
+        /// <para>必填：否</para>
+        /// <para>示例值：****_***</para>
+        /// </summary>
+        [JsonPropertyName("idempotent_id")]
+        public string? IdempotentId { get; set; }
     }
 }

src/Attendance/PostAttendanceV1UserTaskRemedysQueryBodyDto.cs

@@ -14,7 +14,7 @@
 namespace FeishuNetSdk.Attendance;
 /// <summary>
 /// 获取补卡记录 请求体
-/// <para>获取授权内员工的补卡记录。</para>
+/// <para>补卡：用户通过审批的方式，在某一次上/下班的打卡时间范围内，补充一条打卡记录，用以修正用户的考勤结果。本接口专用于获取员工的补卡记录（无页面功能对应）</para>
 /// <para>接口ID：7044467124773666817</para>
 /// <para>文档地址：https://open.feishu.cn/document/server-docs/attendance-v1/user_task_remedy/query</para>
 /// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2freference%2fattendance-v1%2fuser_task_remedy%2fquery</para>
@@ -52,7 +52,7 @@ public record PostAttendanceV1UserTaskRemedysQueryBodyDto
     /// <para>可选值：<list type="bullet">
     /// <item>PeriodTime：单据作用时间</item>
     /// <item>CreateTime：单据创建时间（目前暂不支持）</item>
-    /// <item>UpdateTime：单据状态更新时间（新增字段，对特定租户生效）</item>
+    /// <item>UpdateTime：单据状态更新时间（灰度中，暂不开放）</item>
     /// </list></para>
     /// </summary>
     [JsonPropertyName("check_date_type")]