feat(tiktokshop): 新增获取授权的类目资产列表接口

Author: fudiwei

docs/TikTokGlobalShop/Basic_ModelDefinition.md

@@ -20,6 +20,7 @@ Notes: The following catalog is consistent with the catalog structure of [TikTok
     -   Get Access Token: `AuthGetToken`
     -   Refresh Access Token: `AuthRefreshToken`
 -   Authorization
+    -   Get Authorized Category Assets: `AuthorizationGetCategoryAssets`
     -   Get Authorized Shops: `AuthorizationGetShops`
 -   Event
     -   Get Shop Webhooks: `EventGetWebhooks`

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

@@ -29,5 +29,27 @@ public static class TikTokShopClientExecuteAuthorizationExtensions
 
             return await client.SendFlurlRequesAsJsontAsync<Models.AuthorizationGetShopsResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
         }
+
+        /// <summary>
+        /// <para>异步调用 [GET] /authorization/{version}/category_assets 接口。</para>
+        /// <para>
+        /// REF: <br/>
+        /// <![CDATA[ https://partner.tiktokshop.com/docv2/page/666012dd609d4402cc3be995 ]]>
+        /// </para>
+        /// </summary>
+        /// <param name="client"></param>
+        /// <param name="request"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        public static async Task<Models.AuthorizationGetCategoryAssetsResponse> ExecuteAuthorizationGetCategoryAssetsAsync(this TikTokShopClient client, Models.AuthorizationGetCategoryAssetsRequest 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, "authorization", request.ApiVersion, "category_assets");
+
+            return await client.SendFlurlRequesAsJsontAsync<Models.AuthorizationGetCategoryAssetsResponse>(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false);
+        }
     }
 }

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Models/Authorization/AuthorizationGetCategoryAssetsRequest.cs

@@ -0,0 +1,16 @@
+namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /authorization/{version}/category_assets 接口的请求。</para>
+    /// </summary>
+    public class AuthorizationGetCategoryAssetsRequest : TikTokShopRequest
+    {
+        /// <summary>
+        /// 获取或设置 API 版本号。
+        /// <para>默认值：202405</para>
+        /// </summary>
+        [Newtonsoft.Json.JsonIgnore]
+        [System.Text.Json.Serialization.JsonIgnore]
+        public override int ApiVersion { get; set; } = 202405;
+    }
+}

src/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop/Models/Authorization/AuthorizationGetCategoryAssetsResponse.cs

@@ -0,0 +1,69 @@
+namespace SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.Models
+{
+    /// <summary>
+    /// <para>表示 [GET] /authorization/{version}/category_assets 接口的响应。</para>
+    /// </summary>
+    public class AuthorizationGetCategoryAssetsResponse : TikTokShopResponse<AuthorizationGetCategoryAssetsResponse.Types.Data>
+    {
+        public static class Types
+        {
+            public class Data
+            {
+                public static class Types
+                {
+                    public class CategoryAsset
+                    {
+                        public static class Types
+                        {
+                            public class Category
+                            {
+                                /// <summary>
+                                /// 获取或设置类目 ID。
+                                /// </summary>
+                                [Newtonsoft.Json.JsonProperty("id")]
+                                [System.Text.Json.Serialization.JsonPropertyName("id")]
+                                [System.Text.Json.Serialization.JsonNumberHandling(System.Text.Json.Serialization.JsonNumberHandling.AllowReadingFromString)]
+                                public int CategoryId { get; set; }
+
+                                /// <summary>
+                                /// 获取或设置类目名称。
+                                /// </summary>
+                                [Newtonsoft.Json.JsonProperty("name")]
+                                [System.Text.Json.Serialization.JsonPropertyName("name")]
+                                public string Name { get; set; } = default!;
+                            }
+                        }
+
+                        /// <summary>
+                        /// 获取或设置店铺密码。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("cipher")]
+                        [System.Text.Json.Serialization.JsonPropertyName("cipher")]
+                        public string Cipher { get; set; } = default!;
+
+                        /// <summary>
+                        /// 获取或设置目标市场。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("target_market")]
+                        [System.Text.Json.Serialization.JsonPropertyName("target_market")]
+                        public string TargetMarket { get; set; } = default!;
+
+                        /// <summary>
+                        /// 获取或设置类目信息。
+                        /// </summary>
+                        [Newtonsoft.Json.JsonProperty("category")]
+                        [System.Text.Json.Serialization.JsonPropertyName("category")]
+                        public Types.Category Category { get; set; } = default!;
+                    }
+                }
+
+                /// <summary>
+                /// 获取或设置类目资产列表。
+                /// </summary>
+                [Newtonsoft.Json.JsonProperty("category_assets")]
+                [System.Text.Json.Serialization.JsonPropertyName("category_assets")]
+                public Types.CategoryAsset[] CategoryAssetList { get; set; } = default!;
+            }
+        }
+    }
+}

test/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.UnitTests/ModelSamples/_/Authorization/AuthorizationGetCategoryAssetsResponse.json

@@ -0,0 +1,17 @@
+{
+    "code": 0,
+    "data": {
+        "category_assets": [
+            {
+                "category": {
+                    "id": 3,
+                    "name": "Customer Support"
+                },
+                "cipher": "TTP_XF90igAAAABh0sddwer0qsWgt233vOiG",
+                "target_market": "US"
+            }
+        ]
+    },
+    "message": "Success",
+    "request_id": "202203070749000101890810281E8C70B7"
+}

test/SKIT.FlurlHttpClient.ByteDance.TikTokGlobalShop.UnitTests/ModelSamples/_/Authorization/AuthorizationGetShopsResponse.json

@@ -0,0 +1,17 @@
+{
+    "code": 0,
+    "data": {
+        "shops": [
+            {
+                "cipher": "GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3",
+                "code": "CNGBCBA4LLU8",
+                "id": "7000714532876273420",
+                "name": "Maomao beauty shop",
+                "region": "GB",
+                "seller_type": "CROSS_BORDER"
+            }
+        ]
+    },
+    "message": "Success",
+    "request_id": "202203070749000101890810281E8C70B7"
+}