feat(tiktokshop): 新增获取客服统计数据接口

Author: fudiwei

docs/TikTokGlobalShop/Basic_ModelDefinition.md

@@ -135,6 +135,7 @@ Notes: The following catalog is consistent with the catalog structure of [TikTok
     -   Read Message: `CustomerServiceReadConversationMessage`
     -   Get Agent Settings: `CustomerServiceGetAgentSettings`
     -   Update Agent Settings: `CustomerServiceUpdateAgentSettings`
+    -   Get Customer Service Performance: `CustomerServiceGetPerformance`
 -   Supply Chain
     -   Confirm Package Shipment: `SupplyChainSyncPackages`
 

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Extensions/TikTokShopClientExecuteCustomerServiceExtensions.cs

@@ -57,6 +57,32 @@ public static class TikTokShopClientExecuteCustomerServiceExtensions
         }
         #endregion
 
+        #region Performance
+        /// <summary>
+        /// <para>异步调用 [GET] /customer_service/{version}/performance 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://partner.tiktokshop.com/docv2/page/66bec10859f0b0030018e518 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.CustomerServiceGetPerformanceResponse> ExecuteCustomerServiceGetPerformanceAsync(this TikTokShopClient client, Models.CustomerServiceGetPerformanceRequest request, CancellationToken cancellationToken = default)
+        {
+            if (client is null) throw new ArgumentNullException(nameof(client));
+            if (request is null) throw new ArgumentNullException(nameof(request));
+
+            IFlurlRequest flurlReq = client
+                .CreateFlurlRequest(request, HttpMethod.Get, "customer_service", request.ApiVersion, "performance")
+                .SetQueryParam("support_date_ge", request.SupportDateStringGreaterThan)
+                .SetQueryParam("support_date_lt", request.SupportDateStringLessThan);
+
+            return await client.SendFlurlRequesAsJsontAsync<Models.CustomerServiceGetPerformanceResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
+        #endregion
+
         /// <summary>
         /// <para>异步调用 [POST] /customer_service/{version}/conversations 接口。</para>
         /// <para>

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Models/CustomerService/Performance/CustomerServiceGetPerformanceRequest.cs

@@ -0,0 +1,30 @@
+namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /customer_service/{version}/performance 接口的请求。</para>
+    /// </summary>
+    public class CustomerServiceGetPerformanceRequest : TikTokShopRequest
+    {
+        /// <summary>
+        /// 获取或设置 API 版本号。
+        /// <para>默认值：202407</para>
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public override int ApiVersion { get; set; } = 202407;
+
+        /// <summary>
+        /// 获取或设置日期范围起始时间字符串（格式：yyyy-MM-dd）。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? SupportDateStringGreaterThan { get; set; }
+
+        /// <summary>
+        /// 获取或设置日期范围截止时间字符串（格式：yyyy-MM-dd）。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? SupportDateStringLessThan { get; set; }
+    }
+}

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Models/CustomerService/Performance/CustomerServiceGetPerformanceResponse.cs

@@ -0,0 +1,59 @@
+namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /customer_service/{version}/performance 接口的响应。</para>
+    /// </summary>
+    public class CustomerServiceGetPerformanceResponse : TikTokShopResponse<CustomerServiceGetPerformanceResponse.Types.Data>
+    {
+        public static class Types
+        {
+            public class Data
+            {
+                public static class Types
+                {
+                    public class Performance
+                    {
+                        /// <summary>
+                        /// 获取或设置会话数。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("support_session_count")]
+                        [System.Text.Json.Serialization.JsonPropertyName("support_session_count")]
+                        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.TextualNumberReadOnlyConverter))]
+                        public int SupportSessionCount { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置回复率（单位：百分数）。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("response_percentage")]
+                        [System.Text.Json.Serialization.JsonPropertyName("response_percentage")]
+                        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.TextualNumberReadOnlyConverter))]
+                        public decimal ResponsePercentage { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置客户满意率（单位：百分数）。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("satisfaction_percentage")]
+                        [System.Text.Json.Serialization.JsonPropertyName("satisfaction_percentage")]
+                        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.TextualNumberReadOnlyConverter))]
+                        public decimal SatisfactionPercentage { get; set; }
+
+                        /// <summary>
+                        /// 获取或设置平均首次响应时间（单位：分钟）。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("response_time_mins")]
+                        [System.Text.Json.Serialization.JsonPropertyName("response_time_mins")]
+                        [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.TextualNumberReadOnlyConverter))]
+                        public decimal AverageResponseTime { get; set; }
+                    }
+                }
+
+                /// <summary>
+                /// 获取或设置统计数据。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("performance")]
+                [System.Text.Json.Serialization.JsonPropertyName("performance")]
+                public Types.Performance Performance { get; set; } = default!;
+            }
+        }
+    }
+}

test/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.UnitTests/ModelSamples/_/CustomerService/Performance/CustomerServiceGetPerformanceResponse.json

@@ -0,0 +1,13 @@
+{
+    "code": 0,
+    "data": {
+        "performance": {
+            "response_percentage": "93.4",
+            "response_time_mins": "3.4",
+            "satisfaction_percentage": "95.2",
+            "support_session_count": 15
+        }
+    },
+    "message": "Success",
+    "request_id": "202203070749000101890810281E8C70B7"
+}