feat(tiktokshop): 随官方更新商品分类相关接口模型

fudiwei · Jun 12, 2024 · ae39669 · ae39669
1 parent 2fee1de
commit ae39669
Show file tree

Hide file tree

Showing 8 changed files with 57 additions and 1 deletion.
diff --git a/...pClient.ByteDance.TikTokGlobalShop/Extensions/TikTokShopClientExecuteProductExtensions.cs b/...pClient.ByteDance.TikTokGlobalShop/Extensions/TikTokShopClientExecuteProductExtensions.cs
@@ -29,6 +29,7 @@ public static class TikTokShopClientExecuteProductExtensions
             IFlurlRequest flurlReq = client
                 .CreateFlurlRequest(request, HttpMethod.Get, "product", request.ApiVersion, "brands")
                 .SetQueryParam("category_id", request.CategoryId)
+                .SetQueryParam("category_version", request.CategoryVersion)
                 .SetQueryParam("brand_name", request.BrandName)
                 .SetQueryParam("page_size", request.PageSize)
                 .SetQueryParam("page_token", request.PageToken);
@@ -81,6 +82,8 @@ public static class TikTokShopClientExecuteProductExtensions
 
             IFlurlRequest flurlReq = client
                 .CreateFlurlRequest(request, HttpMethod.Get, "product", request.ApiVersion, "categories")
+                .SetQueryParam("keyword", request.Keyword)
+                .SetQueryParam("category_version", request.CategoryVersion)
                 .SetQueryParam("locale", request.Locale);
 
             return await client.SendFlurlRequesAsJsontAsync<Models.ProductGetCategoriesResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
@@ -103,7 +106,8 @@ public static class TikTokShopClientExecuteProductExtensions
             if (request is null) throw new ArgumentNullException(nameof(request));
 
             IFlurlRequest flurlReq = client
-                .CreateFlurlRequest(request, HttpMethod.Get, "product", request.ApiVersion, "categories", request.CategoryId, "rules");
+                .CreateFlurlRequest(request, HttpMethod.Get, "product", request.ApiVersion, "categories", request.CategoryId, "rules")
+                .SetQueryParam("category_version", request.CategoryVersion);
 
             return await client.SendFlurlRequesAsJsontAsync<Models.ProductGetCategoryRulesResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
         }
@@ -126,6 +130,7 @@ public static class TikTokShopClientExecuteProductExtensions
 
             IFlurlRequest flurlReq = client
                 .CreateFlurlRequest(request, HttpMethod.Get, "product", request.ApiVersion, "categories", request.CategoryId, "attributes")
+                .SetQueryParam("category_version", request.CategoryVersion)
                 .SetQueryParam("locale", request.Locale);
 
             return await client.SendFlurlRequesAsJsontAsync<Models.ProductGetCategoryAttributesResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
@@ -822,6 +827,7 @@ public static class TikTokShopClientExecuteProductExtensions
             IFlurlRequest flurlReq = client
                 .CreateFlurlRequest(request, HttpMethod.Get, "product", request.ApiVersion, "listing_schemas")
                 .SetQueryParam("category_ids", $"[{string.Join(",", request.CategoryIdList)}]")
+                .SetQueryParam("category_version", request.CategoryVersion)
                 .SetQueryParam("locale", request.Locale);
 
             return await client.SendFlurlRequesAsJsontAsync<Models.ProductGetListingSchemasResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);

diff --git a/...lurlHttpClient.ByteDance.TikTokGlobalShop/Models/Product/Brand/ProductGetBrandsRequest.cs b/...lurlHttpClient.ByteDance.TikTokGlobalShop/Models/Product/Brand/ProductGetBrandsRequest.cs
@@ -12,6 +12,13 @@ public class ProductGetBrandsRequest : TikTokShopRequest
         [System.Text.Json.Serialization.JsonIgnore]
         public string? CategoryId { get; set; }
 
+        /// <summary>
+        /// 获取或设置分类版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? CategoryVersion { get; set; }
+
         /// <summary>
         /// 获取或设置是否仅返回已授权品牌。
         /// </summary>

diff --git a/...pClient.ByteDance.TikTokGlobalShop/Models/Product/Category/ProductGetCategoriesRequest.cs b/...pClient.ByteDance.TikTokGlobalShop/Models/Product/Category/ProductGetCategoriesRequest.cs
@@ -5,6 +5,20 @@ namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
     /// </summary>
     public class ProductGetCategoriesRequest : TikTokShopRequest
     {
+        /// <summary>
+        /// 获取或设置关键字。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? Keyword { get; set; }
+
+        /// <summary>
+        /// 获取或设置分类版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? CategoryVersion { get; set; }
+
         /// <summary>
         /// 获取或设置本地化语种。
         /// </summary>

diff --git a/...ByteDance.TikTokGlobalShop/Models/Product/Category/ProductGetCategoryAttributesRequest.cs b/...ByteDance.TikTokGlobalShop/Models/Product/Category/ProductGetCategoryAttributesRequest.cs
@@ -12,6 +12,13 @@ public class ProductGetCategoryAttributesRequest : TikTokShopRequest
         [System.Text.Json.Serialization.JsonIgnore]
         public string CategoryId { get; set; } = string.Empty;
 
+        /// <summary>
+        /// 获取或设置分类版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? CategoryVersion { get; set; }
+
         /// <summary>
         /// 获取或设置本地化语种。
         /// </summary>

diff --git a/...ient.ByteDance.TikTokGlobalShop/Models/Product/Category/ProductGetCategoryRulesRequest.cs b/...ient.ByteDance.TikTokGlobalShop/Models/Product/Category/ProductGetCategoryRulesRequest.cs
@@ -11,5 +11,12 @@ public class ProductGetCategoryRulesRequest : TikTokShopRequest
         [Newtonsoft.Json.JsonIgnore]
         [System.Text.Json.Serialization.JsonIgnore]
         public string CategoryId { get; set; } = string.Empty;
+
+        /// <summary>
+        /// 获取或设置分类版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? CategoryVersion { get; set; }
     }
 }
diff --git a/...t.ByteDance.TikTokGlobalShop/Models/Product/Category/ProductRecommendCategoriesRequest.cs b/...t.ByteDance.TikTokGlobalShop/Models/Product/Category/ProductRecommendCategoriesRequest.cs
@@ -20,6 +20,13 @@ public class Image
             }
         }
 
+        /// <summary>
+        /// 获取或设置分类版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonProperty("category_version")]
+        [System.Text.Json.Serialization.JsonPropertyName("category_version")]
+        public string? CategoryVersion { get; set; }
+
         /// <summary>
         /// 获取或设置商品标题。
         /// </summary>

diff --git a/...rlHttpClient.ByteDance.TikTokGlobalShop/Models/Product/ProductGetListingSchemasRequest.cs b/...rlHttpClient.ByteDance.TikTokGlobalShop/Models/Product/ProductGetListingSchemasRequest.cs
@@ -22,6 +22,13 @@ public class ProductGetListingSchemasRequest : TikTokShopRequest
         [System.Text.Json.Serialization.JsonIgnore]
         public IList<string> CategoryIdList { get; set; } = new List<string>();
 
+        /// <summary>
+        /// 获取或设置分类版本。
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public string? CategoryVersion { get; set; }
+
         /// <summary>
         /// 获取或设置本地化语种。
         /// </summary>

diff --git a/...obalShop.UnitTests/ModelSamples/_/Product/Category/ProductRecommendCategoriesRequest.json b/...obalShop.UnitTests/ModelSamples/_/Product/Category/ProductRecommendCategoriesRequest.json
@@ -1,4 +1,5 @@
 {
+    "category_version": "v1",
     "description": " ",
     "images": [
         {