新增

- 【考勤打卡】查询归档报表表头
- 【考勤打卡】查询所有归档规则
- 【飞书人事（企业版）】通过/拒绝审批任务
- 【应用信息】获取消息推送概览

变更
- 查询统计数据 响应体
- 新建招聘官网投递 请求体

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

src/Application.Spec/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs → src/Application/GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs

@@ -4,14 +4,14 @@
 // Created          : 2024-06-24
 //
 // Last Modified By : yxr
-// Last Modified On : 2024-06-24
+// Last Modified On : 2024-07-24
 // ************************************************************************
 // <copyright file="GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto.cs" company="Vicente Yu">
 //     MIT
 // </copyright>
 // <summary>获取应用反馈列表 响应体</summary>
 // ************************************************************************
-namespace FeishuNetSdk.Application.Spec;
+namespace FeishuNetSdk.Application;
 /// <summary>
 /// 获取应用反馈列表 响应体
 /// <para>查询应用的反馈数据</para>
@@ -24,139 +24,154 @@ public record GetApplicationV6ApplicationsByAppIdFeedbacksResponseDto
     /// <summary>
     /// <para>应用的反馈列表</para>
     /// <para>必填：否</para>
+    /// <para>最大长度：1000</para>
+    /// <para>最小长度：0</para>
     /// </summary>
     [JsonPropertyName("feedback_list")]
-    public ApplicationFeedback[]? FeedbackList { get; set; }
+    public ApplicationFeedback[]? FeedbackLists { get; set; }
 
-    /// <summary></summary>
+    /// <summary>
+    /// <para>应用的反馈列表</para>
+    /// </summary>
     public record ApplicationFeedback
     {
         /// <summary>
         /// <para>应用反馈 ID，应用反馈记录唯一标识</para>
-        /// <para>必填：否</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：7057888018203574291</para>
         /// </summary>
         [JsonPropertyName("feedback_id")]
-        public string? FeedbackId { get; set; }
+        public string FeedbackId { get; set; } = string.Empty;
 
         /// <summary>
         /// <para>被反馈应用ID</para>
-        /// <para>必填：否</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：cli_9b445f5258795107</para>
         /// </summary>
         [JsonPropertyName("app_id")]
-        public string? AppId { get; set; }
+        public string AppId { get; set; } = string.Empty;
 
         /// <summary>
         /// <para>反馈提交时间，格式为yyyy-mm-dd hh:mm:ss</para>
-        /// <para>必填：否</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：2022-01-30 11:30:12</para>
         /// </summary>
         [JsonPropertyName("feedback_time")]
-        public string? FeedbackTime { get; set; }
+        public string FeedbackTime { get; set; } = string.Empty;
 
         /// <summary>
         /// <para>反馈用户的租户名， 查询 isv 应用时返回</para>
         /// <para>必填：否</para>
+        /// <para>示例值：字节跳动</para>
         /// </summary>
         [JsonPropertyName("tenant_name")]
         public string? TenantName { get; set; }
 
         /// <summary>
         /// <para>反馈类型</para>
-        /// <para>**可选值有**：</para>
-        /// <para>1:故障反馈,2:产品建议</para>
-        /// <para>必填：否</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：1</para>
         /// <para>可选值：<list type="bullet">
         /// <item>1：故障反馈</item>
         /// <item>2：产品建议</item>
         /// </list></para>
+        /// <para>默认值：1</para>
         /// </summary>
         [JsonPropertyName("feedback_type")]
-        public int? FeedbackType { get; set; }
+        public int FeedbackType { get; set; }
 
         /// <summary>
         /// <para>反馈处理状态</para>
-        /// <para>**可选值有**：</para>
-        /// <para>0:反馈未处理,1:反馈已处理,2:反馈处理中,3:反馈已关闭</para>
-        /// <para>必填：否</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：0</para>
         /// <para>可选值：<list type="bullet">
         /// <item>0：反馈未处理</item>
         /// <item>1：反馈已处理</item>
         /// <item>2：反馈处理中</item>
         /// <item>3：反馈已关闭</item>
         /// </list></para>
+        /// <para>默认值：0</para>
         /// </summary>
         [JsonPropertyName("status")]
-        public int? Status { get; set; }
+        public int Status { get; set; }
 
         /// <summary>
         /// <para>故障类型列表：1: 黑屏 2: 白屏 3: 无法打开小程序 4: 卡顿 5: 小程序闪退 6: 页面加载慢 7: 死机 8: 其他异常</para>
         /// <para>必填：否</para>
+        /// <para>示例值：[1,2,3]</para>
+        /// <para>最大长度：30</para>
+        /// <para>最小长度：0</para>
         /// </summary>
         [JsonPropertyName("fault_type")]
         public int[]? FaultType { get; set; }
 
         /// <summary>
         /// <para>故障时间，格式为yyyy-mm-dd hh:mm:ss</para>
         /// <para>必填：否</para>
+        /// <para>示例值：2022-01-30 11:30:12</para>
         /// </summary>
         [JsonPropertyName("fault_time")]
         public string? FaultTime { get; set; }
 
         /// <summary>
         /// <para>反馈来源：1： 小程序 2：网页应用 3：机器人 4：webSDK</para>
-        /// <para>**可选值有**：</para>
-        /// <para>1:小程序,2:网页应用,3:机器人,4:WebSDK</para>
         /// <para>必填：否</para>
+        /// <para>示例值：1</para>
         /// <para>可选值：<list type="bullet">
         /// <item>1：小程序</item>
         /// <item>2：网页应用</item>
         /// <item>3：机器人</item>
         /// <item>4：WebSDK</item>
         /// </list></para>
+        /// <para>默认值：1</para>
         /// </summary>
         [JsonPropertyName("source")]
         public int? Source { get; set; }
 
         /// <summary>
         /// <para>用户联系方式，只有用户填写联系方式后返回</para>
-        /// <para>**字段权限要求（满足任一）**：</para>
-        /// <para>&lt;md-perm name="contact:user.email:readonly" desc="获取用户邮箱信息" support_app_types="custom" tags=""&gt;获取用户邮箱信息&lt;/md-perm&gt;</para>
-        /// <para>&lt;md-perm name="contact:user.phone:readonly" desc="获取用户手机号" support_app_types="custom" tags=""&gt;获取用户手机号&lt;/md-perm&gt;</para>
         /// <para>必填：否</para>
+        /// <para>示例值：wang@bytedance.com</para>
         /// </summary>
         [JsonPropertyName("contact")]
         public string? Contact { get; set; }
 
         /// <summary>
         /// <para>反馈处理时间，格式为yyyy-mm-dd hh:mm:ss</para>
         /// <para>必填：否</para>
+        /// <para>示例值：2022-01-30 11:30:12</para>
         /// </summary>
         [JsonPropertyName("update_time")]
         public string? UpdateTime { get; set; }
 
         /// <summary>
         /// <para>反馈问题描述</para>
-        /// <para>必填：否</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：反馈描述</para>
         /// </summary>
         [JsonPropertyName("description")]
-        public string? Description { get; set; }
+        public string Description { get; set; } = string.Empty;
 
         /// <summary>
         /// <para>反馈用户id，租户内用户的唯一标识 ，ID值与查询参数中的user_id_type对应</para>
         /// <para>必填：否</para>
+        /// <para>示例值：ou_9565b69967831233761cc2f11b4c089f</para>
         /// </summary>
         [JsonPropertyName("user_id")]
         public string? UserId { get; set; }
 
         /// <summary>
         /// <para>操作者id，租户内用户的唯一标识， ID值与查询参数中的user_id_type 对应</para>
         /// <para>必填：否</para>
+        /// <para>示例值：ou_9565b69967831233761cc2f11b4c089f</para>
         /// </summary>
         [JsonPropertyName("operator_id")]
         public string? OperatorId { get; set; }
 
         /// <summary>
         /// <para>反馈图片url列表，url 过期时间三天</para>
         /// <para>必填：否</para>
+        /// <para>最大长度：10</para>
         /// </summary>
         [JsonPropertyName("images")]
         public string[]? Images { get; set; }
@@ -167,21 +182,24 @@ public record ApplicationFeedback
         /// <para>- 如触发反馈的应用类型为网页或网页应用，则上报当前网页的url信息</para>
         /// <para>- 如为其他应用类型，则字段返回值为空</para>
         /// <para>必填：否</para>
+        /// <para>示例值：index/page</para>
         /// </summary>
         [JsonPropertyName("feedback_path")]
         public string? FeedbackPath { get; set; }
     }
 
     /// <summary>
-    /// <para>是否还有更多用户反馈列表，true：是，false：否</para>
-    /// <para>必填：否</para>
+    /// <para>是否还有更多项</para>
+    /// <para>必填：是</para>
+    /// <para>示例值：true</para>
     /// </summary>
     [JsonPropertyName("has_more")]
-    public bool? HasMore { get; set; }
+    public bool HasMore { get; set; }
 
     /// <summary>
-    /// <para>拉取下一页应用反馈列表时使用的 page_token</para>
+    /// <para>分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token</para>
     /// <para>必填：否</para>
+    /// <para>示例值：7064688334618378259</para>
     /// </summary>
     [JsonPropertyName("page_token")]
     public string? PageToken { get; set; }

src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto.cs

@@ -0,0 +1,54 @@
+// ************************************************************************
+// Assembly         : FeishuNetSdk
+// Author           : yxr
+// Created          : 2024-07-24
+//
+// Last Modified By : yxr
+// Last Modified On : 2024-07-24
+// ************************************************************************
+// <copyright file="PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto.cs" company="Vicente Yu">
+//     MIT
+// </copyright>
+// <summary>获取消息推送概览 请求体</summary>
+// ************************************************************************
+namespace FeishuNetSdk.Application;
+/// <summary>
+/// 获取消息推送概览 请求体
+/// <para>目标：查看应用在某一天/某一周/某一个月的机器人消息推送数据，可以根据部门做筛选</para>
+/// <para>接口ID：7036626399368953884</para>
+/// <para>文档地址：https://open.feishu.cn/document/server-docs/application-v6/app-usage/message_push_overview</para>
+/// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fapplication-app_usage%2fmessage_push_overview</para>
+/// </summary>
+public record PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewBodyDto
+{
+    /// <summary>
+    /// <para>查询日期，若cycle_type为week，则输入的date必须为周一； 若cycle_type为month，则输入的date必须为每月1号</para>
+    /// <para>必填：是</para>
+    /// <para>示例值：2021-07-08</para>
+    /// </summary>
+    [JsonPropertyName("date")]
+    public string Date { get; set; } = string.Empty;
+
+    /// <summary>
+    /// <para>枚举值：day，week，month；week指自然周，返回当前日期所在周的数据；不满一周则从周一到当前日期算。month指自然月，返回当前日期所在月的数据。</para>
+    /// <para>必填：是</para>
+    /// <para>示例值：1</para>
+    /// <para>可选值：<list type="bullet">
+    /// <item>1：日活，指自然日，返回当前日期所在日的数据</item>
+    /// <item>2：周活，指自然周，返回当前日期所在周的数据。若到查询时当周还没结束，则返回周一到当前日期的数值。例如在2021/7/15 查询2021/7/5 这一周的数据，则代表的是2021/7/5 ~ 2021/7/11。但若是在2021/7/8 查询2021/7/5 这一周的数据，则返回的是2021/7/5 ~ 2021/7/7 的数据</item>
+    /// <item>3：月活，指自然月，返回当前日期所在月的数据。若不满一个月则返回当月1日到截止日期前的数据。例如在2021/8/15 查询 7月的数据，则代表2021/7/1~2021/7/31。 若在2021/8/15 查询8月的数据，则代表2021/8/1~2021/8/14的数据</item>
+    /// </list></para>
+    /// </summary>
+    [JsonPropertyName("cycle_type")]
+    public int CycleType { get; set; }
+
+    /// <summary>
+    /// <para>需要查询的部门id，获取方法可参考[部门ID概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview)</para>
+    /// <para>- 若部门id为空，则返回当前租户的使用数据；若填写部门id，则返回当前部门的使用数据（包含子部门的用户）；</para>
+    /// <para>- 若路径参数中department_id_type为空或者为open_department_id，则此处应该填写部门的 open_department_id；若路径参数中department_id_type为department_id，则此处应该填写部门的 department_id。返回当前部门的使用数据； 若不填写，则返回当前租户的使用数据</para>
+    /// <para>必填：否</para>
+    /// <para>示例值：od-4e6ac4d14bcd5071a37a39de902c7141</para>
+    /// </summary>
+    [JsonPropertyName("department_id")]
+    public string? DepartmentId { get; set; }
+}

src/Application/PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto.cs

@@ -0,0 +1,53 @@
+// ************************************************************************
+// Assembly         : FeishuNetSdk
+// Author           : yxr
+// Created          : 2024-07-24
+//
+// Last Modified By : yxr
+// Last Modified On : 2024-07-24
+// ************************************************************************
+// <copyright file="PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto.cs" company="Vicente Yu">
+//     MIT
+// </copyright>
+// <summary>获取消息推送概览 响应体</summary>
+// ************************************************************************
+namespace FeishuNetSdk.Application;
+/// <summary>
+/// 获取消息推送概览 响应体
+/// <para>目标：查看应用在某一天/某一周/某一个月的机器人消息推送数据，可以根据部门做筛选</para>
+/// <para>接口ID：7036626399368953884</para>
+/// <para>文档地址：https://open.feishu.cn/document/server-docs/application-v6/app-usage/message_push_overview</para>
+/// <para>JSON地址：https://open.feishu.cn/document_portal/v1/document/get_detail?fullPath=%2fuAjLw4CM%2fukTMukTMukTM%2fapplication-v6%2fapplication-app_usage%2fmessage_push_overview</para>
+/// </summary>
+public record PostApplicationV6ApplicationsByAppIdAppUsageMessagePushOverviewResponseDto
+{
+    /// <summary>
+    /// <para>消息推送情况，指标值包括：send_msg_count：消息推送数、send_user_count：消息触达人数、read_in_1h_count：消息1h阅读量、read_in_12h_count：消息12h阅读量</para>
+    /// <para>必填：否</para>
+    /// <para>最大长度：10</para>
+    /// </summary>
+    [JsonPropertyName("items")]
+    public ApplicationAppUsage[]? Items { get; set; }
+
+    /// <summary>
+    /// <para>消息推送情况，指标值包括：send_msg_count：消息推送数、send_user_count：消息触达人数、read_in_1h_count：消息1h阅读量、read_in_12h_count：消息12h阅读量</para>
+    /// </summary>
+    public record ApplicationAppUsage
+    {
+        /// <summary>
+        /// <para>指标名称</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：pv</para>
+        /// </summary>
+        [JsonPropertyName("metric_name")]
+        public string MetricName { get; set; } = string.Empty;
+
+        /// <summary>
+        /// <para>指标值</para>
+        /// <para>必填：是</para>
+        /// <para>示例值：100</para>
+        /// </summary>
+        [JsonPropertyName("metric_value")]
+        public int MetricValue { get; set; }
+    }
+}

src/Approval/PostApprovalV4TasksSearchResponseDto.cs

@@ -381,7 +381,7 @@ public record InstanceSearchLink
             public string? UpdateTime { get; set; }
 
             /// <summary>
-            /// <para>三方审批扩展 ID</para>
+            /// <para>三方审批扩展 任务ID</para>
             /// <para>必填：否</para>
             /// <para>示例值：123123daddf21313</para>
             /// </summary>