tccli-intl-en 3.1.13.1__py2.py3-none-any.whl → 3.1.39.1__py2.py3-none-any.whl

tccli/services/ses/v20201002/api.json

@@ -14,6 +14,13 @@
       "output": "CreateAddressUnsubscribeConfigResponse",
       "status": "online"
     },
+    "CreateCustomBlacklist": {
+      "document": "Add a custom blocklist.",
+      "input": "CreateCustomBlacklistRequest",
+      "name": "Batch add custom blocklist",
+      "output": "CreateCustomBlacklistResponse",
+      "status": "online"
+    },
     "CreateEmailAddress": {
       "document": "After the sender domain is verified, you need a sender address to send emails. For example, if your sender domain is mail.qcloud.com, your sender address can be service@mail.qcloud.com. If you want to display your name (such as \"Tencent Cloud\") in the inbox list of the recipients, the sender address should be in the format of `Tencent Cloud <email address>`. Please note that there must be a space between your name and the first angle bracket.",
       "input": "CreateEmailAddressRequest",
@@ -49,6 +56,13 @@
       "output": "CreateReceiverDetailResponse",
       "status": "online"
     },
+    "CreateReceiverDetailWithData": {
+      "document": "Add recipient addresses with Template parameters. Use this API to import Template parameters while adding recipient addresses, ensuring each recipient address uses Template variables with different values when sending emails. Users first call the CreateReceiver API to create a recipient list, then call this API to import recipient addresses and Template parameters for email sending, and finally use the BatchSendEmail API to complete batch email sending. Notably, after using this API, the Template parameter in the BatchSendEmail API does not need to be passed again. Users can also import recipient addresses, Template variables, and parameter values via the import file option in the console under Email Sending - Recipient List menu. This API limits the number of recipient addresses in a single request to 20,000 entries. It can also append recipient addresses to an already uploaded recipient list, but the total number of recipient addresses in the list must not exceed a certain limit, currently set at 50,000 entries. This API does not support removing duplicate recipient addresses. Users need to ensure uploaded and appended addresses are non-repeating and do not duplicate previously uploaded addresses.",
+      "input": "CreateReceiverDetailWithDataRequest",
+      "name": "Add a recipient address and attach template parameters",
+      "output": "CreateReceiverDetailWithDataResponse",
+      "status": "online"
+    },
     "DeleteAddressUnsubscribeConfig": {
       "document": "Remove address-level unsubscribe configuration.",
       "input": "DeleteAddressUnsubscribeConfigRequest",
@@ -63,6 +77,13 @@
       "output": "DeleteBlackListResponse",
       "status": "online"
     },
+    "DeleteCustomBlackList": {
+      "document": "Delete a custom blocklist email address.",
+      "input": "DeleteCustomBlackListRequest",
+      "name": "Delete a custom blocklist",
+      "output": "DeleteCustomBlackListResponse",
+      "status": "online"
+    },
     "DeleteEmailAddress": {
       "document": "This API is used to delete a sender address.",
       "input": "DeleteEmailAddressRequest",
@@ -106,9 +127,9 @@
       "status": "online"
     },
     "GetSendEmailStatus": {
-      "document": "This API is used to get email sending status. Only data within 30 days can be queried.\nDefault API request rate limit: 1 request/sec.",
+      "document": "Search the email sending status. Only support querying data within 30 days.",
       "input": "GetSendEmailStatusRequest",
-      "name": "Gets the email sending status (to be disused)",
+      "name": "Query the email sending status",
       "output": "GetSendEmailStatusResponse",
       "status": "online"
     },
@@ -133,6 +154,13 @@
       "output": "ListBlackEmailAddressResponse",
       "status": "online"
     },
+    "ListCustomBlacklist": {
+      "document": "Retrieve the custom blocklist.",
+      "input": "ListCustomBlacklistRequest",
+      "name": "Retrieve the custom blocklist",
+      "output": "ListCustomBlacklistResponse",
+      "status": "online"
+    },
     "ListEmailAddress": {
       "document": "This API is used to get the list of sender addresses.",
       "input": "ListEmailAddressRequest",
@@ -154,6 +182,13 @@
       "output": "ListEmailTemplatesResponse",
       "status": "online"
     },
+    "ListReceiverDetails": {
+      "document": "Query ALL recipient email addresses in the recipient list based on the recipient list id with paging query. Filter queries can be based on the recipient email address.",
+      "input": "ListReceiverDetailsRequest",
+      "name": "Query a certain recipient list detail",
+      "output": "ListReceiverDetailsResponse",
+      "status": "online"
+    },
     "ListReceivers": {
       "document": "This API is used to query recipient groups. It supports pagination, fuzzy query, and query by status.",
       "input": "ListReceiversRequest",
@@ -182,6 +217,13 @@
       "output": "UpdateAddressUnsubscribeConfigResponse",
       "status": "online"
     },
+    "UpdateCustomBlackList": {
+      "document": "Refresh custom blocklist.",
+      "input": "UpdateCustomBlackListRequest",
+      "name": "Update a custom blocklist",
+      "output": "UpdateCustomBlackListResponse",
+      "status": "online"
+    },
     "UpdateEmailIdentity": {
       "document": "This API is used to verify whether your DNS configuration is correct.",
       "input": "UpdateEmailIdentityRequest",
@@ -259,18 +301,25 @@
           "member": "string",
           "name": "FileName",
           "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "string"
         },
         {
           "disabled": false,
-          "document": "Base64-encoded attachment content. You can send attachments of up to 4 MB in the total size. Note: The TencentCloud API supports a request packet of up to 8 MB in size, and the size of the attachment content will increase by 1.5 times after Base64 encoding. Therefore, you need to keep the total size of all attachments below 4 MB. If the entire request exceeds 8 MB, the API will return an error.",
+          "document": "The Base64-encoded attachment content supports a maximum of 4M. note: tencent cloud API supports up to 8M request packets. the attachment content is expected to expand by 1.5 times after Base64 encoding. you should control the total size of all attachments within 4M. the API will return an error if the overall request exceeds 8M.",
           "example": "dGhpcyBpcyBhIGV4YW1wbGU=",
           "member": "string",
           "name": "Content",
-          "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Attachment URL. do not use the open function.",
+          "example": "https://www.test.com/1.png",
+          "member": "string",
+          "name": "FileURL",
+          "required": false,
+          "type": "string"
         }
       ],
       "usage": "in"
@@ -280,8 +329,8 @@
       "members": [
         {
           "disabled": false,
-          "document": "Sender address. Enter a sender address such as `noreply@mail.qcloud.com`. To display the sender name, enter the address in the following format:\nsender &lt;email address&gt;. For example:\nTencent Cloud team &lt;noreply@mail.qcloud.com&gt;",
-          "example": "abc@ef.com",
+          "document": "Sender'S email address. please fill in the sender's email address, such as noreply@mail.qcloud.com. if you need to fill in the sender's description, please follow.\nSender &lt;email address&gt; via fill in, such as:.\nTencent cloud team &lt;noreply@mail.qcloud.com&gt;.",
+          "example": "test@example.com",
           "member": "string",
           "name": "FromEmailAddress",
           "required": true,
@@ -289,8 +338,8 @@
         },
         {
           "disabled": false,
-          "document": "Recipient group ID",
-          "example": "123",
+          "document": "Recipient list ID.",
+          "example": "1",
           "member": "uint64",
           "name": "ReceiverId",
           "required": true,
@@ -298,7 +347,7 @@
         },
         {
           "disabled": false,
-          "document": "Email subject",
+          "document": "Email subject.",
           "example": "邮件主题",
           "member": "string",
           "name": "Subject",
@@ -307,7 +356,7 @@
         },
         {
           "disabled": false,
-          "document": "Task type. `1`: immediate; `2`: scheduled; `3`: recurring",
+          "document": "Task type 1: send now 2: scheduled sending 3: cycle (frequency) sending.",
           "example": "1",
           "member": "uint64",
           "name": "TaskType",
@@ -316,8 +365,8 @@
         },
         {
           "disabled": false,
-          "document": "Reply-to address. You can enter a valid personal email address that can receive emails. If this parameter is left empty, reply emails will fail to be sent.",
-          "example": "abc@ef.com",
+          "document": "The \"reply\" email address of the mail. can be filled with an email address you can receive mail from, can be a personal mailbox. if left empty, the recipient's reply mail will fail to send.",
+          "example": "test@example.com",
           "member": "string",
           "name": "ReplyToAddresses",
           "required": false,
@@ -325,7 +374,7 @@
         },
         {
           "disabled": false,
-          "document": "Template when emails are sent using a template",
+          "document": "When using a template to send, fill in the related parameters of the template.\n<Dx-Alert infotype=\"notice\" title=\"note\">this field must be specified if you have not applied for special configuration.</dx-alert>.",
           "example": "无",
           "member": "Template",
           "name": "Template",
@@ -334,7 +383,7 @@
         },
         {
           "disabled": false,
-          "document": "Disused",
+          "document": "Abandoned<Dx-Alert infotype=\"notice\" title=\"description\">only customers who historically applied for special configuration require the use of it. if you have not applied for special configuration, this field does not exist.</dx-alert>.",
           "example": "无",
           "member": "Simple",
           "name": "Simple",
@@ -343,7 +392,7 @@
         },
         {
           "disabled": false,
-          "document": "Attachment parameters to set when you need to send attachments. This parameter is currently unavailable.",
+          "document": "Send attachment when required. fill in related parameters (not supported).",
           "example": "无",
           "member": "Attachment",
           "name": "Attachments",
@@ -352,7 +401,7 @@
         },
         {
           "disabled": false,
-          "document": "Parameter required for a recurring sending task",
+          "document": "Required parameter for sending tasks periodically.",
           "example": "无",
           "member": "CycleEmailParam",
           "name": "CycleParam",
@@ -361,7 +410,7 @@
         },
         {
           "disabled": false,
-          "document": "Parameter required for a scheduled sending task",
+          "document": "Required parameter for scheduled task assignment.",
           "example": "无",
           "member": "TimedEmailParam",
           "name": "TimedParam",
@@ -370,7 +419,7 @@
         },
         {
           "disabled": false,
-          "document": "Unsubscribe link option. `0`: Do not add unsubscribe link; `1`: English `2`: Simplified Chinese; `3`: Traditional Chinese; `4`: Spanish; `5`: French; `6`: German; `7`: Japanese; `8`: Korean; `9`: Arabic; `10`: Thai",
+          "document": "Unsubscription link options 0: do not add 1: english 2: simplified chinese 3: traditional chinese 4: spanish 5: french 6: german 7: japanese 8: korean 9: arabic 10: thai.",
           "example": "1",
           "member": "string",
           "name": "Unsubscribe",
@@ -379,7 +428,7 @@
         },
         {
           "disabled": false,
-          "document": "Whether to add an ad tag. `0`: Add no tag; `1`: Add before the subject; `2`: Add after the subject.",
+          "document": "Whether to add an ad flag. valid values: 0 (do not add), 1 (add to the previous subject), 2 (add to the following subject).",
           "example": "0",
           "member": "uint64",
           "name": "ADLocation",
@@ -394,15 +443,16 @@
       "members": [
         {
           "disabled": false,
-          "document": "Sending task ID",
-          "example": "123",
+          "document": "Send task ID.",
+          "example": "1",
           "member": "uint64",
           "name": "TaskId",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -410,24 +460,92 @@
       ],
       "type": "object"
     },
+    "BlackAddressDetail": {
+      "document": "Blocklist description.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Blocklist address id.",
+          "example": "1",
+          "member": "uint64",
+          "name": "Id",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Email address.",
+          "example": "example@mail.com",
+          "member": "string",
+          "name": "Email",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Creation time.\n\n",
+          "example": "2024-06-26 16:46:30",
+          "member": "string",
+          "name": "CreateTime",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Expiration time",
+          "example": "2024-06-19",
+          "member": "string",
+          "name": "ExpireDate",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Blocklist status. valid values: 0 (expired), 1 (active).",
+          "example": "1",
+          "member": "uint64",
+          "name": "Status",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "BlackEmailAddress": {
-      "document": "Email address blocklist structure, including the blocklisted address and the time when it is blocklisted.",
+      "document": "Email blocklist structure describes the blocked email address, blocklist time, and reason.",
       "members": [
         {
           "disabled": false,
           "document": "Time when the email address is blocklisted.",
+          "example": "2024-12-24 02:09:33",
           "member": "datetime",
           "name": "BounceTime",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Blocklisted email address.",
+          "example": "block@example.com",
           "member": "string",
           "name": "EmailAddress",
-          "required": true,
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Reason for being blacklisted.",
+          "example": "552 1 Requested mail action aborted, mailbox not found",
+          "member": "string",
+          "name": "IspDesc",
+          "output_required": false,
           "type": "string",
           "value_allowed_null": false
         }
@@ -479,12 +597,99 @@
       ],
       "type": "object"
     },
+    "CreateCustomBlacklistRequest": {
+      "document": "CreateCustomBlacklist request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Add to blocklist email address.",
+          "example": "[ \"a@gmail.com\" , \"b@gmail.com\"]",
+          "member": "string",
+          "name": "Emails",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Expiration date.",
+          "example": "\"2024-06-19\"",
+          "member": "date",
+          "name": "ExpireDate",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateCustomBlacklistResponse": {
+      "document": "CreateCustomBlacklist response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Total number of recipients.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TotalCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Actual uploaded quantity.",
+          "example": "1",
+          "member": "uint64",
+          "name": "ValidCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Data too long quantity.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TooLongCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Repetition count.",
+          "example": "1",
+          "member": "uint64",
+          "name": "RepeatCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Incorrect format count.",
+          "example": "1",
+          "member": "uint64",
+          "name": "InvalidCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "CreateEmailAddressRequest": {
       "document": "CreateEmailAddress request structure.",
       "members": [
         {
           "disabled": false,
           "document": "Your sender address. (You can create up to 10 sender addresses for each domain.)",
+          "example": "service@mail.qcloud.com",
           "member": "string",
           "name": "EmailAddress",
           "required": true,
@@ -493,6 +698,7 @@
         {
           "disabled": false,
           "document": "Sender name.",
+          "example": "腾讯云邮件通知",
           "member": "string",
           "name": "EmailSenderName",
           "required": false,
@@ -505,7 +711,7 @@
       "document": "CreateEmailAddress response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -519,10 +725,29 @@
         {
           "disabled": false,
           "document": "Your sender domain. You are advised to use a third-level domain, for example, mail.qcloud.com.",
+          "example": "mail.qcloud.com",
           "member": "string",
           "name": "EmailIdentity",
           "required": true,
           "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Generated dkim key length. valid values: 0 (1024), 1 (2048).",
+          "example": "0",
+          "member": "uint64",
+          "name": "DKIMOption",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "tag.",
+          "example": "无",
+          "member": "TagList",
+          "name": "TagList",
+          "required": false,
+          "type": "list"
         }
       ],
       "type": "object"
@@ -533,29 +758,35 @@
         {
           "disabled": false,
           "document": "Verification type. The value is fixed to `DOMAIN`.",
+          "example": "DOMAIN",
           "member": "string",
           "name": "IdentityType",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Verification passed or not.",
+          "example": "true",
           "member": "bool",
           "name": "VerifiedForSendingStatus",
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "DNS information that needs to be configured.",
+          "example": "无",
           "member": "DNSAttributes",
           "name": "Attributes",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -569,6 +800,7 @@
         {
           "disabled": false,
           "document": "Template name.",
+          "example": "TestName",
           "member": "string",
           "name": "TemplateName",
           "required": true,
@@ -577,6 +809,7 @@
         {
           "disabled": false,
           "document": "Template content.",
+          "example": "无",
           "member": "TemplateContent",
           "name": "TemplateContent",
           "required": true,
@@ -591,15 +824,15 @@
         {
           "disabled": false,
           "document": "Template ID",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "TemplateID",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -613,7 +846,7 @@
         {
           "disabled": false,
           "document": "Recipient group ID",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "ReceiverId",
           "required": true,
@@ -622,7 +855,7 @@
         {
           "disabled": false,
           "document": "Email address",
-          "example": "[\"xxx@abc.com\"]",
+          "example": "[\"example@gmail.com\"]",
           "member": "string",
           "name": "Emails",
           "required": true,
@@ -635,53 +868,57 @@
       "document": "CreateReceiverDetail response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
-          "member": "string",
-          "name": "RequestId",
-          "type": "string"
-        }
-      ],
-      "type": "object"
-    },
-    "CreateReceiverRequest": {
-      "document": "CreateReceiver request structure.",
-      "members": [
+          "disabled": false,
+          "document": "Total number of recipients.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TotalCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
         {
           "disabled": false,
-          "document": "Recipient group name",
-          "example": "收件人列表",
-          "member": "string",
-          "name": "ReceiversName",
-          "required": true,
-          "type": "string"
+          "document": "Actual uploaded quantity.",
+          "example": "1",
+          "member": "uint64",
+          "name": "ValidCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Recipient group description",
-          "example": "收件人列表描述",
-          "member": "string",
-          "name": "Desc",
-          "required": false,
-          "type": "string"
-        }
-      ],
-      "type": "object"
-    },
-    "CreateReceiverResponse": {
-      "document": "CreateReceiver response structure.",
-      "members": [
+          "document": "Data too long quantity.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TooLongCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
         {
           "disabled": false,
-          "document": "Recipient group ID, by which recipient email addresses are uploaded",
-          "example": "123",
+          "document": "Number of empty email addresses.",
+          "example": "1",
           "member": "uint64",
-          "name": "ReceiverId",
-          "required": true,
+          "name": "EmptyEmailCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Repetition count.",
+          "example": "1",
+          "member": "uint64",
+          "name": "RepeatCount",
+          "output_required": false,
           "type": "int",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -689,25 +926,159 @@
       ],
       "type": "object"
     },
-    "CycleEmailParam": {
-      "document": "Parameter required to create a recurring sending task",
+    "CreateReceiverDetailWithDataRequest": {
+      "document": "CreateReceiverDetailWithData request structure.",
       "members": [
         {
           "disabled": false,
-          "document": "Start time of the task",
-          "example": "2021-09-11 09:10:11",
-          "member": "string",
-          "name": "BeginTime",
+          "document": "Recipient list ID.",
+          "example": "1",
+          "member": "uint64",
+          "name": "ReceiverId",
           "required": true,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "int"
         },
         {
           "disabled": false,
-          "document": "Task recurrence in hours",
+          "document": "Recipient mailbox and template parameters in array format. limit on the number of recipients not exceeding 20000.",
+          "example": "无",
+          "member": "ReceiverInputData",
+          "name": "Datas",
+          "required": true,
+          "type": "list"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateReceiverDetailWithDataResponse": {
+      "document": "CreateReceiverDetailWithData response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Recipient total number.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TotalCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Uploaded quantity.",
+          "example": "1",
+          "member": "uint64",
+          "name": "ValidCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Data too long quantity.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TooLongCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Number of empty email addresses.",
+          "example": "1",
+          "member": "uint64",
+          "name": "EmptyEmailCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Repetition count.",
+          "example": "1",
+          "member": "uint64",
+          "name": "RepeatCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateReceiverRequest": {
+      "document": "CreateReceiver request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Recipient group name",
+          "example": "收件人列表",
+          "member": "string",
+          "name": "ReceiversName",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Recipient group description",
+          "example": "收件人列表描述",
+          "member": "string",
+          "name": "Desc",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "CreateReceiverResponse": {
+      "document": "CreateReceiver response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Recipient group ID, by which recipient email addresses are uploaded",
+          "example": "1",
+          "member": "uint64",
+          "name": "ReceiverId",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "CycleEmailParam": {
+      "document": "Parameter required to create a recurring sending task",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Start time of the task",
+          "example": "2021-09-11 09:10:11",
+          "member": "string",
+          "name": "BeginTime",
+          "output_required": false,
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Task recurrence in hours",
           "example": "1",
           "member": "uint64",
           "name": "IntervalTime",
+          "output_required": false,
           "required": true,
           "type": "int",
           "value_allowed_null": false
@@ -718,12 +1089,13 @@
           "example": "0",
           "member": "uint64",
           "name": "TermCycle",
+          "output_required": false,
           "required": false,
           "type": "int",
           "value_allowed_null": false
         }
       ],
-      "usage": "in"
+      "usage": "both"
     },
     "DNSAttributes": {
       "document": "Describes the domain name, record type, expected value, and currently configured value of DNS records.",
@@ -731,45 +1103,50 @@
         {
           "disabled": false,
           "document": "Record types: CNAME, A, TXT, and MX.",
+          "example": "TXT",
           "member": "string",
           "name": "Type",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Domain name.",
+          "example": "example.com",
           "member": "string",
           "name": "SendDomain",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Expected value.",
+          "example": "v=spf1 include:qcloudmail.com ~all",
           "member": "string",
           "name": "ExpectedValue",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Currently configured value.",
+          "example": "v=spf1 include:qcloudmail.com ~all",
           "member": "string",
           "name": "CurrentValue",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Approved or not. The default value is `false`.",
+          "example": "true",
           "member": "bool",
           "name": "Status",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         }
@@ -809,6 +1186,7 @@
         {
           "disabled": false,
           "document": "List of email addresses to be unblocklisted. Enter at least one address.",
+          "example": "example@gmail.com",
           "member": "string",
           "name": "EmailAddressList",
           "required": true,
@@ -821,7 +1199,34 @@
       "document": "DeleteBlackList response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "DeleteCustomBlackListRequest": {
+      "document": "DeleteCustomBlackList request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Email address that needs to be deleted.",
+          "example": "[\"a@mail.com\",\"b@mail.com\"]",
+          "member": "string",
+          "name": "Emails",
+          "required": true,
+          "type": "list"
+        }
+      ],
+      "type": "object"
+    },
+    "DeleteCustomBlackListResponse": {
+      "document": "DeleteCustomBlackList response structure.",
+      "members": [
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -835,6 +1240,7 @@
         {
           "disabled": false,
           "document": "Sender address.",
+          "example": "test@example.com",
           "member": "string",
           "name": "EmailAddress",
           "required": true,
@@ -847,7 +1253,7 @@
       "document": "DeleteEmailAddress response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -861,6 +1267,7 @@
         {
           "disabled": false,
           "document": "Sender domain.",
+          "example": "example.com",
           "member": "string",
           "name": "EmailIdentity",
           "required": true,
@@ -873,7 +1280,7 @@
       "document": "DeleteEmailIdentity response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -900,7 +1307,7 @@
       "document": "DeleteEmailTemplate response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -927,7 +1334,7 @@
       "document": "DeleteReceiver response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -944,7 +1351,7 @@
           "example": "mail.qcloud.com",
           "member": "string",
           "name": "IdentityName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -954,7 +1361,7 @@
           "example": "DOMAIN",
           "member": "string",
           "name": "IdentityType",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -964,7 +1371,7 @@
           "example": "false",
           "member": "bool",
           "name": "SendingEnabled",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
@@ -974,7 +1381,7 @@
           "example": "10",
           "member": "uint64",
           "name": "CurrentReputationLevel",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -984,9 +1391,29 @@
           "example": "10000",
           "member": "uint64",
           "name": "DailyQuota",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Independent ip for domain configuration.",
+          "example": "[\"0.0.0.0\",\"1.1.1.1\"]",
+          "member": "string",
+          "name": "SendIp",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "tag.",
+          "example": "无",
+          "member": "TagList",
+          "name": "TagList",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
         }
       ],
       "usage": "out"
@@ -997,29 +1424,42 @@
         {
           "disabled": false,
           "document": "Sender address.",
+          "example": "sender@example.com",
           "member": "string",
           "name": "EmailAddress",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Sender name.\nNote: this field may return `null`, indicating that no valid values can be obtained.",
+          "document": "Sender alias.",
+          "example": "name",
           "member": "string",
           "name": "EmailSenderName",
-          "required": true,
+          "output_required": true,
           "type": "string",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Creation time.\nNote: this field may return `null`, indicating that no valid values can be obtained.",
+          "document": "Creation time.\n\n",
+          "example": "2024-12-10 16:44:16",
           "member": "uint64",
           "name": "CreatedTimestamp",
-          "required": true,
+          "output_required": true,
           "type": "int",
-          "value_allowed_null": true
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "smtp password type. 0=not set. 1=already set up.",
+          "example": "0",
+          "member": "uint64",
+          "name": "SmtpPwdType",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
         }
       ],
       "usage": "out"
@@ -1030,6 +1470,7 @@
         {
           "disabled": false,
           "document": "Sender domain.",
+          "example": "example.com",
           "member": "string",
           "name": "EmailIdentity",
           "required": true,
@@ -1044,29 +1485,35 @@
         {
           "disabled": false,
           "document": "Verification type. The value is fixed to `DOMAIN`.",
+          "example": "DOMAIN",
           "member": "string",
           "name": "IdentityType",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Verification passed or not.",
+          "example": "true",
           "member": "bool",
           "name": "VerifiedForSendingStatus",
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "DNS configuration details.",
+          "example": "无",
           "member": "DNSAttributes",
           "name": "Attributes",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1080,6 +1527,7 @@
         {
           "disabled": false,
           "document": "Template ID.",
+          "example": "10091",
           "member": "uint64",
           "name": "TemplateID",
           "required": true,
@@ -1122,7 +1570,7 @@
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1190,12 +1638,12 @@
           "example": "无",
           "member": "SendEmailStatus",
           "name": "EmailStatusList",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1209,6 +1657,7 @@
         {
           "disabled": false,
           "document": "Start date.",
+          "example": "2020-10-01",
           "member": "date",
           "name": "StartDate",
           "required": true,
@@ -1217,6 +1666,7 @@
         {
           "disabled": false,
           "document": "End date.",
+          "example": "2020-10-03",
           "member": "date",
           "name": "EndDate",
           "required": true,
@@ -1225,6 +1675,7 @@
         {
           "disabled": false,
           "document": "Sender domain.",
+          "example": "qcloud.com",
           "member": "string",
           "name": "Domain",
           "required": false,
@@ -1233,6 +1684,7 @@
         {
           "disabled": false,
           "document": "Recipient address type, for example, gmail.com.",
+          "example": "gmail.com",
           "member": "string",
           "name": "ReceivingMailboxType",
           "required": false,
@@ -1247,21 +1699,25 @@
         {
           "disabled": false,
           "document": "Daily email sending statistics.",
+          "example": "无",
           "member": "Volume",
           "name": "DailyVolumes",
+          "required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Overall email sending statistics.",
+          "example": "无",
           "member": "Volume",
           "name": "OverallVolume",
+          "required": true,
           "type": "object",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1331,6 +1787,7 @@
         {
           "disabled": false,
           "document": "Start date in the format of `YYYY-MM-DD`",
+          "example": "2023-09-01",
           "member": "date",
           "name": "StartDate",
           "required": true,
@@ -1339,6 +1796,7 @@
         {
           "disabled": false,
           "document": "End date in the format of `YYYY-MM-DD`",
+          "example": "2023-09-02",
           "member": "date",
           "name": "EndDate",
           "required": true,
@@ -1347,6 +1805,7 @@
         {
           "disabled": false,
           "document": "Common parameter. It must be used with `Offset`.",
+          "example": "10",
           "member": "uint64",
           "name": "Limit",
           "required": true,
@@ -1355,6 +1814,7 @@
         {
           "disabled": false,
           "document": "Common parameter. It must be used with `Limit`. Maximum value of `Limit`: `100`.",
+          "example": "0",
           "member": "uint64",
           "name": "Offset",
           "required": true,
@@ -1363,6 +1823,7 @@
         {
           "disabled": false,
           "document": "You can specify an email address to query.",
+          "example": "xx@gmail.com",
           "member": "string",
           "name": "EmailAddress",
           "required": false,
@@ -1370,7 +1831,8 @@
         },
         {
           "disabled": false,
-          "document": "You can specify a task ID to query.",
+          "document": "This parameter has been deprecated.",
+          "example": "已废弃",
           "member": "string",
           "name": "TaskID",
           "required": false,
@@ -1385,21 +1847,99 @@
         {
           "disabled": false,
           "document": "List of blocklisted addresses.",
+          "example": "无",
           "member": "BlackEmailAddress",
           "name": "BlackList",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Total number of blocklisted addresses.",
+          "example": "1",
           "member": "uint64",
           "name": "TotalCount",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "ListCustomBlacklistRequest": {
+      "document": "ListCustomBlacklist request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Offset, int, starts from 0.",
+          "example": "1",
+          "member": "uint64",
+          "name": "Offset",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Number limit, int, no more than 100.",
+          "example": "10",
+          "member": "uint64",
+          "name": "Limit",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Filter the state of the blocklist. valid values: 0 (expired), 1 (active), 2 (all).",
+          "example": "2",
+          "member": "uint64",
+          "name": "Status",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Email address in blocklist.",
+          "example": "a@mail.com",
+          "member": "string",
+          "name": "Email",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "ListCustomBlacklistResponse": {
+      "document": "ListCustomBlacklist response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Total Quantity of Lists",
+          "example": "10",
+          "member": "uint64",
+          "name": "TotalCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Blocklist description.",
+          "example": "无",
+          "member": "BlackAddressDetail",
+          "name": "Data",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1417,14 +1957,16 @@
       "members": [
         {
           "disabled": false,
-          "document": "Details of sender addresses.\nNote: this field may return `null`, indicating that no valid values can be obtained.",
+          "document": "List of sender addresses description.",
+          "example": "[{\"EmailAddress\":\"one@mail.cloudses.com\",\"EmailSenderName\":\"oneName\",\"CreatedTimestamp\":1685096987,\"SmtpPwdType\":0},{\"EmailAddress\":\"two@mail.cloudses.com\",\"EmailSenderName\":\"twoName\",\"CreatedTimestamp\":1682393466,\"SmtpPwdType\":1}]",
           "member": "EmailSender",
           "name": "EmailSenders",
+          "output_required": true,
           "type": "list",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1434,7 +1976,35 @@
     },
     "ListEmailIdentitiesRequest": {
       "document": "ListEmailIdentities request structure.",
-      "members": [],
+      "members": [
+        {
+          "disabled": false,
+          "document": "tag.",
+          "example": "无",
+          "member": "TagList",
+          "name": "TagList",
+          "required": false,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "Pagination limit.",
+          "example": "100",
+          "member": "uint64",
+          "name": "Limit",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Paging offset.",
+          "example": "10",
+          "member": "uint64",
+          "name": "Offset",
+          "required": false,
+          "type": "int"
+        }
+      ],
       "type": "object"
     },
     "ListEmailIdentitiesResponse": {
@@ -1446,7 +2016,7 @@
           "example": "无",
           "member": "EmailIdentity",
           "name": "EmailIdentities",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -1456,7 +2026,7 @@
           "example": "10",
           "member": "uint64",
           "name": "MaxReputationLevel",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -1466,12 +2036,22 @@
           "example": "10000",
           "member": "uint64",
           "name": "MaxDailyQuota",
-          "required": true,
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Total number.",
+          "example": "100",
+          "member": "uint64",
+          "name": "Total",
+          "output_required": false,
           "type": "int",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1485,7 +2065,7 @@
         {
           "disabled": false,
           "document": "Number of templates to get. This parameter is used for pagination.",
-          "example": "0",
+          "example": "10",
           "member": "uint64",
           "name": "Limit",
           "required": true,
@@ -1494,7 +2074,7 @@
         {
           "disabled": false,
           "document": "Template offset to get. This parameter is used for pagination.",
-          "example": "10",
+          "example": "0",
           "member": "uint64",
           "name": "Offset",
           "required": true,
@@ -1512,7 +2092,7 @@
           "example": "无",
           "member": "TemplatesMetadata",
           "name": "TemplatesMetadata",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
@@ -1522,12 +2102,133 @@
           "example": "1",
           "member": "uint64",
           "name": "TotalCount",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "ListReceiverDetailsRequest": {
+      "document": "ListReceiverDetails request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Recipient list ID. specifies the value returned during API creation of a recipient list via the CreateReceiver api.",
+          "example": "1",
+          "member": "uint64",
+          "name": "ReceiverId",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Offset, int, starts from 0.",
+          "example": "1",
+          "member": "uint64",
+          "name": "Offset",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Number limit, int, no more than 100.",
+          "example": "10",
+          "member": "uint64",
+          "name": "Limit",
           "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Recipient address. length: 0-50. example: xxx@te.com. fuzzy query is supported.",
+          "example": "test@example.com",
+          "member": "string",
+          "name": "Email",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Find start time.",
+          "example": "2024-08-13",
+          "member": "string",
+          "name": "CreateTimeBegin",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Search end time.",
+          "example": "2024-08-14",
+          "member": "string",
+          "name": "CreateTimeEnd",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "1: valid; 2: invalid.",
+          "example": "1",
+          "member": "uint64",
+          "name": "Status",
+          "required": false,
+          "type": "int"
+        }
+      ],
+      "type": "object"
+    },
+    "ListReceiverDetailsResponse": {
+      "document": "ListReceiverDetails response structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Total number.",
+          "example": "1",
+          "member": "uint64",
+          "name": "TotalCount",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Data record.",
+          "example": "无",
+          "member": "ReceiverDetail",
+          "name": "Data",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Number of valid email addresses.",
+          "example": "1",
+          "member": "uint64",
+          "name": "ValidCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Number of invalid email addresses.",
+          "example": "1",
+          "member": "uint64",
+          "name": "InvalidCount",
+          "output_required": false,
           "type": "int",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1583,10 +2284,10 @@
         {
           "disabled": false,
           "document": "Total number",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "TotalCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -1596,12 +2297,12 @@
           "example": "无",
           "member": "ReceiverData",
           "name": "Data",
-          "required": true,
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1642,7 +2343,7 @@
         {
           "disabled": false,
           "document": "Recipient group ID",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "ReceiverId",
           "required": false,
@@ -1666,105 +2367,207 @@
         {
           "disabled": false,
           "document": "Total number",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "TotalCount",
-          "required": true,
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Data record",
+          "example": "无",
+          "member": "SendTaskData",
+          "name": "Data",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "ReceiverData": {
+      "document": "Recipient group data type",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Recipient group ID",
+          "example": "1",
+          "member": "uint64",
+          "name": "ReceiverId",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Recipient group name",
+          "example": "收件人列表",
+          "member": "string",
+          "name": "ReceiversName",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Total number of recipient email addresses",
+          "example": "1",
+          "member": "uint64",
+          "name": "Count",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Recipient list description.",
+          "example": "收件人列表描述",
+          "member": "string",
+          "name": "Desc",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "List status (1 to be uploaded 2 uploading 3 upload complete).",
+          "example": "1",
+          "member": "uint64",
+          "name": "ReceiversStatus",
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Data record",
-          "example": "无",
-          "member": "SendTaskData",
-          "name": "Data",
-          "required": true,
-          "type": "list",
+          "document": "Creation time, such as 2021-09-28 16:40:35",
+          "example": "2021-09-28 16:40:35",
+          "member": "string",
+          "name": "CreateTime",
+          "output_required": true,
+          "type": "string",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
-          "member": "string",
-          "name": "RequestId",
-          "type": "string"
+          "disabled": false,
+          "document": "Invalid number of recipients.",
+          "example": "1",
+          "member": "uint64",
+          "name": "InvalidCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
         }
       ],
-      "type": "object"
+      "usage": "out"
     },
-    "ReceiverData": {
-      "document": "Recipient group data type",
+    "ReceiverDetail": {
+      "document": "Recipient list details.",
       "members": [
         {
           "disabled": false,
-          "document": "Recipient group ID",
-          "example": "123",
-          "member": "uint64",
-          "name": "ReceiverId",
-          "required": true,
-          "type": "int",
+          "document": "Recipient's address.",
+          "example": "123@abc.com",
+          "member": "string",
+          "name": "Email",
+          "output_required": true,
+          "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Recipient group name",
-          "example": "收件人列表",
+          "document": "Creation time.\n\n",
+          "example": "2021-09-09 12:13:14",
           "member": "string",
-          "name": "ReceiversName",
-          "required": true,
+          "name": "CreateTime",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Total number of recipient email addresses",
-          "example": "1",
-          "member": "uint64",
-          "name": "Count",
-          "required": true,
-          "type": "int",
+          "document": "Template parameter.",
+          "example": "{\"name\":\"xxx\",\"age\":\"xx\"}",
+          "member": "string",
+          "name": "TemplateData",
+          "output_required": true,
+          "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Recipient group description\nNote: This field may return `null`, indicating that no valid value can be found.",
-          "example": "收件人列表描述",
+          "document": "Invalid reason.",
+          "example": "无效原因",
           "member": "string",
-          "name": "Desc",
-          "required": true,
+          "name": "Reason",
+          "output_required": false,
           "type": "string",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Group status (`1`: to be uploaded; `2` uploading; `3` uploaded)\nNote: This field may return `null`, indicating that no valid value can be found.",
+          "document": "1: valid; 2: invalid.",
           "example": "1",
           "member": "uint64",
-          "name": "ReceiversStatus",
-          "required": true,
+          "name": "Status",
+          "output_required": false,
           "type": "int",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Creation time, such as 2021-09-28 16:40:35",
-          "example": "2021-09-28 16:40:35",
+          "document": "Recipient address id.",
+          "example": "1",
+          "member": "uint64",
+          "name": "EmailId",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
+    "ReceiverInputData": {
+      "document": "Recipient details input parameter, including recipient email and template parameter.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Recipient email.",
+          "example": "abc@ef.com",
           "member": "string",
-          "name": "CreateTime",
+          "name": "Email",
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "For variable parameters in template, please use json.dump to format the json object into string type. the object is a set of Key-value pairs. each Key represents a variable in template. variable usage in template is represented by {{Key}}. the appropriate value will be replaced with {{value}} when sent.\nNote: the parameter value cannot be data of complex type such as html. the entire JSON structure of TemplateData has a length limit of 800 bytes.",
+          "example": "{\"name\":\"xxx\",\"age\":\"xx\"}",
+          "member": "string",
+          "name": "TemplateData",
           "required": true,
           "type": "string",
           "value_allowed_null": false
         }
       ],
-      "usage": "out"
+      "usage": "in"
     },
     "SendEmailRequest": {
       "document": "SendEmail request structure.",
       "members": [
         {
           "disabled": false,
-          "document": "Sender address. Enter a sender address, for example, noreply@mail.qcloud.com.\nTo display the sender name, enter the address in the following format: \nSender <email address>",
-          "example": "noreply@mail.qcloud.com",
+          "document": "Sender'S email address. when not using an alias, enter the sender's email address directly, for example: noreply@mail.qcloud.com. to enter a sender alias, follow this format (note that a space must separate the alias and email address): alias+space+<email address>. the alias cannot contain a colon (:).",
+          "example": "QCLOUDTEAM &ltnoreply@mail.qcloud.com&gt",
           "member": "string",
           "name": "FromEmailAddress",
           "required": true,
@@ -1772,8 +2575,8 @@
         },
         {
           "disabled": false,
-          "document": "Recipient email addresses. You can send an email to up to 50 recipients at a time. Note: the email content will display all recipient addresses. To send one-to-one emails to several recipients, please call the API multiple times to send the emails.",
-          "example": "无",
+          "document": "Recipient email address, supports up to 50 recipients in mass sending. note: the email content displays all recipient addresses. for non-mass sending, call the API multiple times to send.",
+          "example": "[\"destination@mail.qcloud.com\"]",
           "member": "string",
           "name": "Destination",
           "required": true,
@@ -1790,7 +2593,7 @@
         },
         {
           "disabled": false,
-          "document": "Reply-to address. You can enter a valid personal email address that can receive emails. If this parameter is left empty, reply emails will fail to be sent.",
+          "document": "The \"reply\" email address of the mail. can be filled with an email address where you can receive mail, which can be a personal mailbox. if left empty, the recipient's reply mail will fail to send.",
           "example": "noreply@mail.qcloud.com",
           "member": "string",
           "name": "ReplyToAddresses",
@@ -1799,8 +2602,8 @@
         },
         {
           "disabled": false,
-          "document": "",
-          "example": "无",
+          "document": "Cc recipient email address, supports up to 20 carbon copies.",
+          "example": "[\"cc@mail.qcloud.com\"]",
           "member": "string",
           "name": "Cc",
           "required": false,
@@ -1808,8 +2611,8 @@
         },
         {
           "disabled": false,
-          "document": "",
-          "example": "无",
+          "document": "Bcc email address, supports up to 20 carbon copies. Bcc and Destination must be unique.",
+          "example": "[\"bcc@mail.qcloud.com\"]",
           "member": "string",
           "name": "Bcc",
           "required": false,
@@ -1817,7 +2620,7 @@
         },
         {
           "disabled": false,
-          "document": "Template parameters for template-based sending. As `Simple` has been disused, `Template` is required.",
+          "document": "Use template for sending and fill in related parameters.\n<dx-alert infotype=\"notice\" title=\"note\">this field must be specified if you have not applied for special configuration.</dx-alert>.",
           "example": "无",
           "member": "Template",
           "name": "Template",
@@ -1826,7 +2629,7 @@
         },
         {
           "disabled": false,
-          "document": "Disused",
+          "document": "This parameter has been deprecated.\n<dx-alert infotype=\"notice\" title=\"description\"> only customers who have applied for special configuration in the past need to use this. if you have not applied for special configuration, this field does not exist.</dx-alert>.",
           "example": "无",
           "member": "Simple",
           "name": "Simple",
@@ -1835,7 +2638,7 @@
         },
         {
           "disabled": false,
-          "document": "Parameters for the attachments to be sent. The TencentCloud API supports a request packet of up to 8 MB in size, and the size of the attachment content will increase by 1.5 times after Base64 encoding. Therefore, you need to keep the total size of all attachments below 4 MB. If the entire request exceeds 8 MB, the API will return an error.",
+          "document": "When sending an attachment, fill in the related parameters. the tencent cloud API request supports a maximum of 8M request packet. the attachment content transits Base64 and is expected to expand by 1.5 times. you should control the total size of all attachments within 4M. the API will return an error if the overall request exceeds 8M.",
           "example": "无",
           "member": "Attachment",
           "name": "Attachments",
@@ -1844,7 +2647,7 @@
         },
         {
           "disabled": false,
-          "document": "Unsubscribe link option. `0`: Do not add unsubscribe link; `1`: English `2`: Simplified Chinese; `3`: Traditional Chinese; `4`: Spanish; `5`: French; `6`: German; `7`: Japanese; `8`: Korean; `9`: Arabic; `10`: Thai",
+          "document": "Unsubscription link options 0: do not add unsubscription link 1: english 2: simplified chinese 3: traditional chinese 4: spanish 5: french 6: german 7: japanese 8: korean 9: arabic 10: thai.",
           "example": "1",
           "member": "string",
           "name": "Unsubscribe",
@@ -1853,12 +2656,39 @@
         },
         {
           "disabled": false,
-          "document": "Email triggering type. `0` (default): non-trigger-based, suitable for marketing emails and non-immediate emails; `1`: trigger-based, suitable for immediate emails such as emails containing verification codes. If the size of an email exceeds a specified value, the system will automatically choose the non-trigger-based type.",
+          "document": "Mail trigger type. 0: non-trigger class, default type, select this type for marketing emails and non-instant emails. 1: trigger class, instant delivery emails such as captcha-intl. if the mail exceeds a certain size, the system will automatically select the non-trigger class channel.",
           "example": "1",
           "member": "uint64",
           "name": "TriggerType",
           "required": false,
           "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "Message-Id field in the smtp header.",
+          "example": "<2SNZPF1T2NU4.5OB8TNNRVRYM3@qcloudmail.com>",
+          "member": "string",
+          "name": "SmtpMessageId",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Other fields that can be set in the smtp header.",
+          "example": "{\"header1\": \"value1\", \"header2\": \"value2\"}",
+          "member": "string",
+          "name": "SmtpHeaders",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "from field in the smtp header. the domain name should be consistent with FromEmailAddress.",
+          "example": "noreply@mail.qcloud.com",
+          "member": "string",
+          "name": "HeaderFrom",
+          "required": false,
+          "type": "string"
         }
       ],
       "type": "object"
@@ -1868,15 +2698,16 @@
       "members": [
         {
           "disabled": false,
-          "document": "Unique ID generated when receiving the message",
+          "document": "Uniquely generated message identifier for receive message.",
           "example": "qcloud-ses-messageid",
           "member": "string",
           "name": "MessageId",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -1893,27 +2724,27 @@
           "example": "qcloudses-30-4123414323-date-20210101094334-syNARhMTbKI1",
           "member": "string",
           "name": "MessageId",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Recipient email address",
-          "example": "abc@ef.com",
+          "example": "address@example.com",
           "member": "string",
           "name": "ToEmailAddress",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Sender email address",
-          "example": "abc@ef.com",
+          "example": "address@example.com",
           "member": "string",
           "name": "FromEmailAddress",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -1923,7 +2754,7 @@
           "example": "0",
           "member": "int64",
           "name": "SendStatus",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -1933,17 +2764,17 @@
           "example": "0",
           "member": "int64",
           "name": "DeliverStatus",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Description of the recipient processing status",
-          "example": "无",
+          "example": "550 Mailbox unavailable or access denied ",
           "member": "string",
           "name": "DeliverMessage",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -1953,7 +2784,7 @@
           "example": "1609831698",
           "member": "int64",
           "name": "RequestTime",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -1963,7 +2794,7 @@
           "example": "1609831698",
           "member": "int64",
           "name": "DeliverTime",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -1973,7 +2804,7 @@
           "example": "true",
           "member": "bool",
           "name": "UserOpened",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
@@ -1983,7 +2814,7 @@
           "example": "true",
           "member": "bool",
           "name": "UserClicked",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
@@ -1993,17 +2824,27 @@
           "example": "true",
           "member": "bool",
           "name": "UserUnsubscribed",
-          "required": true,
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
         {
-          "disabled": false,
+          "disabled": true,
           "document": "Whether the recipient has reported the sender",
           "example": "true",
           "member": "bool",
           "name": "UserComplainted",
-          "required": true,
+          "output_required": true,
+          "type": "bool",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Whether the user reports the sender.",
+          "example": "true",
+          "member": "bool",
+          "name": "UserComplained",
+          "output_required": false,
           "type": "bool",
           "value_allowed_null": false
         }
@@ -2019,27 +2860,27 @@
           "example": "1",
           "member": "uint64",
           "name": "TaskId",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Sender address",
-          "example": "123@abc.com",
+          "example": "address@example.com",
           "member": "string",
           "name": "FromEmailAddress",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Recipient group ID",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "ReceiverId",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2049,7 +2890,7 @@
           "example": "1",
           "member": "uint64",
           "name": "TaskStatus",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2059,7 +2900,7 @@
           "example": "1",
           "member": "uint64",
           "name": "TaskType",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2069,7 +2910,7 @@
           "example": "1",
           "member": "uint64",
           "name": "RequestCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2079,7 +2920,7 @@
           "example": "1",
           "member": "uint64",
           "name": "SendCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2089,7 +2930,7 @@
           "example": "1",
           "member": "uint64",
           "name": "CacheCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
@@ -2099,7 +2940,7 @@
           "example": "2021-09-09 12:12:13",
           "member": "string",
           "name": "CreateTime",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -2109,7 +2950,7 @@
           "example": "2021-09-09 12:12:13",
           "member": "string",
           "name": "UpdateTime",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
@@ -2119,19 +2960,19 @@
           "example": "邮件主题",
           "member": "string",
           "name": "Subject",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Template and template data\nNote: This field may return `null`, indicating that no valid value can be found.",
+          "document": "Template and template data.",
           "example": "无",
           "member": "Template",
           "name": "Template",
-          "required": true,
+          "output_required": true,
           "type": "object",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
@@ -2139,7 +2980,7 @@
           "example": "无",
           "member": "CycleEmailParam",
           "name": "CycleParam",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": true
         },
@@ -2149,19 +2990,19 @@
           "example": "无",
           "member": "TimedEmailParam",
           "name": "TimedParam",
-          "required": true,
+          "output_required": true,
           "type": "object",
           "value_allowed_null": true
         },
         {
           "disabled": false,
-          "document": "Task exception information\nNote: This field may return `null`, indicating that no valid value can be found.",
+          "document": "Task exception information.",
           "example": "余额不足",
           "member": "string",
           "name": "ErrMsg",
-          "required": true,
+          "output_required": true,
           "type": "string",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
@@ -2169,7 +3010,7 @@
           "example": "收件人列表名称",
           "member": "string",
           "name": "ReceiversName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         }
@@ -2182,23 +3023,51 @@
         {
           "disabled": false,
           "document": "HTML code after base64 encoding. To ensure correct display, this parameter should include all code information and cannot contain external CSS.",
+          "example": "PGh0bWw+PGhlYWQ+PHRpdGxlPkV4YW1wbGUgSFRNTDwvdGl0bGU+PC9oZWFkPjxib2R5PjxwPkhlbGxvLCB3b3JsZDwvcD48L2JvZHk+PC9odG1sPg==",
           "member": "string",
           "name": "Html",
           "required": false,
-          "type": "string",
-          "value_allowed_null": false
+          "type": "string"
         },
         {
           "disabled": false,
           "document": "Plain text content after base64 encoding. If HTML is not involved, the plain text will be displayed in the email. Otherwise, this parameter represents the plain text style of the email.",
+          "example": "SGVsbG8sIHdvcmxkIQ==",
           "member": "string",
           "name": "Text",
           "required": false,
+          "type": "string"
+        }
+      ],
+      "usage": "in"
+    },
+    "TagList": {
+      "document": "Tag.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Product.",
+          "example": "tagkey",
+          "member": "string",
+          "name": "TagKey",
+          "output_required": true,
+          "required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "ses",
+          "example": "tagvalue",
+          "member": "string",
+          "name": "TagValue",
+          "output_required": true,
+          "required": true,
           "type": "string",
           "value_allowed_null": false
         }
       ],
-      "usage": "in"
+      "usage": "both"
     },
     "Template": {
       "document": "Template information, including template ID, template variable parameters, etc.",
@@ -2206,9 +3075,10 @@
         {
           "disabled": false,
           "document": "Template ID. If you don’t have any template, please create one.",
-          "example": "123",
+          "example": "1",
           "member": "uint64",
           "name": "TemplateID",
+          "output_required": false,
           "required": true,
           "type": "int",
           "value_allowed_null": false
@@ -2216,15 +3086,16 @@
         {
           "disabled": false,
           "document": "Variable parameters in the template. Please use `json.dump` to format the JSON object into a string type. The object is a set of key-value pairs. Each key denotes a variable, which is represented by {{key}}. The key will be replaced with the corresponding value (represented by {{value}}) when sending the email.\nNote: The parameter value cannot be data of a complex type such as HTML.\nExample: {\"name\":\"xxx\",\"age\":\"xx\"}",
-          "example": "{\"name\":\"xxx\",\"age\":\"xx\"}",
+          "example": "{\"name\":\"andy\",\"age\":\"24\"}",
           "member": "string",
           "name": "TemplateData",
+          "output_required": false,
           "required": true,
           "type": "string",
           "value_allowed_null": false
         }
       ],
-      "usage": "in"
+      "usage": "both"
     },
     "TemplateContent": {
       "document": "Template content, which must include at least one of TEXT and HTML. A combination of TEXT and HTML is recommended.",
@@ -2232,8 +3103,10 @@
         {
           "disabled": false,
           "document": "HTML code after base64 encoding.",
+          "example": "PGh0bWw+PGhlYWQ+PHRpdGxlPkV4YW1wbGUgSFRNTDwvdGl0bGU+PC9oZWFkPjxib2R5PjxwPkhlbGxvLCB3b3JsZDwvcD48L2JvZHk+PC9odG1sPg==",
           "member": "string",
           "name": "Html",
+          "output_required": false,
           "required": false,
           "type": "string",
           "value_allowed_null": false
@@ -2241,14 +3114,16 @@
         {
           "disabled": false,
           "document": "Text content after base64 encoding.",
+          "example": "SGVsbG8sIHdvcmxkIQ==",
           "member": "string",
           "name": "Text",
+          "output_required": false,
           "required": false,
           "type": "string",
           "value_allowed_null": false
         }
       ],
-      "usage": "in"
+      "usage": "both"
     },
     "TemplatesMetadata": {
       "document": "Template list structure.",
@@ -2256,45 +3131,50 @@
         {
           "disabled": false,
           "document": "Creation time.",
+          "example": "1724757008",
           "member": "uint64",
           "name": "CreatedTimestamp",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Template name.",
+          "example": "exampleTemplate",
           "member": "string",
           "name": "TemplateName",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Template status. 1: under review; 0: approved; 2: rejected; other values: unavailable.",
+          "example": "1",
           "member": "int64",
           "name": "TemplateStatus",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Template ID.",
+          "example": "251252329",
           "member": "uint64",
           "name": "TemplateID",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Review reply",
+          "example": "禁止发送未经收件人许可的电子邮件。",
           "member": "string",
           "name": "ReviewReason",
-          "required": true,
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         }
@@ -2310,12 +3190,13 @@
           "example": "2021-09-11 09:10:11",
           "member": "string",
           "name": "BeginTime",
+          "output_required": false,
           "required": true,
           "type": "string",
           "value_allowed_null": false
         }
       ],
-      "usage": "in"
+      "usage": "both"
     },
     "UpdateAddressUnsubscribeConfigRequest": {
       "document": "UpdateAddressUnsubscribeConfig request structure.",
@@ -2362,12 +3243,58 @@
       ],
       "type": "object"
     },
+    "UpdateCustomBlackListRequest": {
+      "document": "UpdateCustomBlackList request structure.",
+      "members": [
+        {
+          "disabled": false,
+          "document": "Blocklist id that needs to change.",
+          "example": "1",
+          "member": "uint64",
+          "name": "Id",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "After modification email address.",
+          "example": "a@mail.com",
+          "member": "string",
+          "name": "Email",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Expiration time. if left empty, it indicates permanent validity.",
+          "example": "2024-06-19",
+          "member": "string",
+          "name": "ExpireDate",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "UpdateCustomBlackListResponse": {
+      "document": "UpdateCustomBlackList response structure.",
+      "members": [
+        {
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "UpdateEmailIdentityRequest": {
       "document": "UpdateEmailIdentity request structure.",
       "members": [
         {
           "disabled": false,
           "document": "Domain to be verified.",
+          "example": "example.com",
           "member": "string",
           "name": "EmailIdentity",
           "required": true,
@@ -2382,29 +3309,35 @@
         {
           "disabled": false,
           "document": "Verification type. The value is fixed to `DOMAIN`.",
+          "example": "DOMAIN",
           "member": "string",
           "name": "IdentityType",
+          "output_required": true,
           "type": "string",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Verification passed or not.",
+          "example": "true",
           "member": "bool",
           "name": "VerifiedForSendingStatus",
+          "output_required": true,
           "type": "bool",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "DNS information that needs to be configured.",
+          "example": "无",
           "member": "DNSAttributes",
           "name": "Attributes",
+          "output_required": true,
           "type": "list",
           "value_allowed_null": false
         },
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -2418,7 +3351,7 @@
         {
           "disabled": false,
           "document": "SMTP password. Length limit: 64.",
-          "example": "123",
+          "example": "yourPassword",
           "member": "string",
           "name": "Password",
           "required": true,
@@ -2427,7 +3360,7 @@
         {
           "disabled": false,
           "document": "Email address. Length limit: 128.",
-          "example": "123@abc.com",
+          "example": "address@example.com",
           "member": "string",
           "name": "EmailAddress",
           "required": true,
@@ -2440,7 +3373,7 @@
       "document": "UpdateEmailSmtpPassWord response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -2472,7 +3405,7 @@
         {
           "disabled": false,
           "document": "Template name",
-          "example": "xx",
+          "example": "myTemplateName",
           "member": "string",
           "name": "TemplateName",
           "required": true,
@@ -2485,7 +3418,7 @@
       "document": "UpdateEmailTemplate response structure.",
       "members": [
         {
-          "document": "The unique request ID, which is returned for each request. RequestId is required for locating a problem.",
+          "document": "The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.",
           "member": "string",
           "name": "RequestId",
           "type": "string"
@@ -2498,75 +3431,83 @@
       "members": [
         {
           "disabled": false,
-          "document": "Date\nNote: this field may return `null`, indicating that no valid values can be obtained.",
+          "document": "Date",
+          "example": "2024-08-08",
           "member": "date",
           "name": "SendDate",
-          "required": true,
+          "output_required": true,
           "type": "string",
-          "value_allowed_null": true
+          "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of email requests.",
+          "example": "2",
           "member": "uint64",
           "name": "RequestCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of email requests accepted by Tencent Cloud.",
+          "example": "1",
           "member": "uint64",
           "name": "AcceptedCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of delivered emails.",
+          "example": "1",
           "member": "uint64",
           "name": "DeliveredCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of users (deduplicated) who opened emails.",
+          "example": "0",
           "member": "uint64",
           "name": "OpenedCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of recipients who clicked on links in emails.",
+          "example": "0",
           "member": "uint64",
           "name": "ClickedCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
           "document": "Number of bounced emails.",
+          "example": "0",
           "member": "uint64",
           "name": "BounceCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
           "value_allowed_null": false
         },
         {
           "disabled": false,
-          "document": "Number of users who canceled subscriptions.\nNote: this field may return `null`, indicating that no valid values can be obtained.",
+          "document": "Number of users for unsubscription.",
+          "example": "0",
           "member": "uint64",
           "name": "UnsubscribeCount",
-          "required": true,
+          "output_required": true,
           "type": "int",
-          "value_allowed_null": true
+          "value_allowed_null": false
         }
       ],
       "usage": "out"