tencent cloud
Attachment
Attachment structure, including attachment name and Base64-encoded attachment content
Used by actions: BatchSendEmail, SendEmail.
Name | Type | Required | Description |
---|---|---|---|
FileName | String | Yes | Attachment name, which cannot exceed 255 characters. Some attachment types are not supported. For details, see Attachment Types. |
Content | String | Yes | 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. |
BlackEmailAddress
Email address blocklist structure, including the blocklisted address and the time when it is blocklisted.
Used by actions: ListBlackEmailAddress.
Name | Type | Description |
---|---|---|
BounceTime | Timestamp | Time when the email address is blocklisted. |
EmailAddress | String | Blocklisted email address. |
CycleEmailParam
Parameter required to create a recurring sending task
Used by actions: BatchSendEmail, ListSendTasks.
Name | Type | Required | Description |
---|---|---|---|
BeginTime | String | Yes | Start time of the task |
IntervalTime | Integer | Yes | Task recurrence in hours |
TermCycle | Integer | No | Specifies whether to end the cycle. This parameter is used to update the task. Valid values: 0: No; 1: Yes. |
DNSAttributes
Describes the domain name, record type, expected value, and currently configured value of DNS records.
Used by actions: CreateEmailIdentity, GetEmailIdentity, UpdateEmailIdentity.
Name | Type | Description |
---|---|---|
Type | String | Record types: CNAME, A, TXT, and MX. |
SendDomain | String | Domain name. |
ExpectedValue | String | Expected value. |
CurrentValue | String | Currently configured value. |
Status | Boolean | Approved or not. The default value is false . |
EmailIdentity
Sender domain verification list structure
Used by actions: ListEmailIdentities.
Name | Type | Description |
---|---|---|
IdentityName | String | Sender domain. |
IdentityType | String | Verification type. The value is fixed to DOMAIN . |
SendingEnabled | Boolean | Verification passed or not. |
CurrentReputationLevel | Integer | Current reputation level |
DailyQuota | Integer | Maximum number of messages sent per day |
EmailSender
Describes sender information.
Used by actions: ListEmailAddress.
Name | Type | Description |
---|---|---|
EmailAddress | String | Sender address. |
EmailSenderName | String | Sender name. Note: this field may return null , indicating that no valid values can be obtained. |
CreatedTimestamp | Integer | Creation time. Note: this field may return null , indicating that no valid values can be obtained. |
ReceiverData
Recipient group data type
Used by actions: ListReceivers.
Name | Type | Description |
---|---|---|
ReceiverId | Integer | Recipient group ID |
ReceiversName | String | Recipient group name |
Count | Integer | Total number of recipient email addresses |
Desc | String | Recipient group description Note: This field may return null , indicating that no valid value can be found. |
ReceiversStatus | Integer | Group status (1 : to be uploaded; 2 uploading; 3 uploaded)Note: This field may return null , indicating that no valid value can be found. |
CreateTime | String | Creation time, such as 2021-09-28 16:40:35 |
SendEmailStatus
Describes the email sending status
Used by actions: GetSendEmailStatus.
Name | Type | Description |
---|---|---|
MessageId | String | The MessageId field returned by the SendEmail API |
ToEmailAddress | String | Recipient email address |
FromEmailAddress | String | Sender email address |
SendStatus | Integer | Tencent Cloud processing status 0: Successful. 1001: Internal system exception. 1002: Internal system exception. 1003: Internal system exception. 1003: Internal system exception. 1004: Email sending timed out. 1005: Internal system exception. 1006: You have sent too many emails to the same address in a short period. 1007: The email address is in the blocklist. 1008: The sender domain is rejected by the recipient. 1009: Internal system exception. 1010: The daily email sending limit is exceeded. 1011: You have no permission to send custom content. Use a template. 1013: The sender domain is unsubscribed from by the recipient. 2001: No results were found. 3007: The template ID is invalid or the template is unavailable. 3008: The sender domain is temporarily blocked by the recipient domain. 3009: You have no permission to use this template. 3010: The format of the TemplateData field is incorrect. 3014: The email cannot be sent because the sender domain is not verified. 3020: The recipient email address is in the blocklist. 3024: Failed to precheck the email address format. 3030: Email sending is restricted temporarily due to a high bounce rate. 3033: The account has insufficient balance or overdue payment. |
DeliverStatus | Integer | Recipient processing status 0: Tencent Cloud has accepted the request and added it to the send queue. 1: The email is delivered successfully. DeliverTime indicates the time when the email is delivered successfully.2: The email is discarded. DeliverMessage indicates the reason for discarding.3: The recipient's ESP rejects the email, probably because the email address does not exist or due to other reasons. 8: The email is delayed by the ESP. DeliverMessage indicates the reason for delay. |
DeliverMessage | String | Description of the recipient processing status |
RequestTime | Integer | Timestamp when the request arrives at Tencent Cloud |
DeliverTime | Integer | Timestamp when Tencent Cloud delivers the email |
UserOpened | Boolean | Whether the recipient has opened the email |
UserClicked | Boolean | Whether the recipient has clicked the links in the email |
UserUnsubscribed | Boolean | Whether the recipient has unsubscribed from the email sent by the sender |
UserComplainted | Boolean | Whether the recipient has reported the sender |
SendTaskData
Email sending task data
Used by actions: ListSendTasks.
Name | Type | Description |
---|---|---|
TaskId | Integer | Task ID |
FromEmailAddress | String | Sender address |
ReceiverId | Integer | Recipient group ID |
TaskStatus | Integer | Task status. 1 : to start; 5 : sending; 6 : sending suspended today; 7 : sending error; 10 : sent |
TaskType | Integer | Task type. 1 : immediate; 2 : scheduled; 3 : recurring |
RequestCount | Integer | Number of emails requested to be sent |
SendCount | Integer | Number of emails sent |
CacheCount | Integer | Number of emails cached |
CreateTime | String | Task creation time |
UpdateTime | String | Task update time |
Subject | String | Email subject |
Template | Template | Template and template data Note: This field may return null , indicating that no valid value can be found. |
CycleParam | CycleEmailParam | Parameters of a recurring task Note: This field may return null , indicating that no valid value can be found. |
TimedParam | TimedEmailParam | Parameters of a scheduled task Note: This field may return null , indicating that no valid value can be found. |
ErrMsg | String | Task exception information Note: This field may return null , indicating that no valid value can be found. |
ReceiversName | String | Recipient group name |
Simple
Email content, which can be plain text (TEXT), pure code (HTML), or a combination of TEXT and HTML (recommended).
Used by actions: BatchSendEmail, SendEmail.
Name | Type | Required | Description |
---|---|---|---|
Html | String | No | HTML code after base64 encoding. To ensure correct display, this parameter should include all code information and cannot contain external CSS. |
Text | String | No | 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. |
Template
Template information, including template ID, template variable parameters, etc.
Used by actions: BatchSendEmail, ListSendTasks, SendEmail.
Name | Type | Required | Description |
---|---|---|---|
TemplateID | Integer | Yes | Template ID. If you don’t have any template, please create one. |
TemplateData | String | Yes | 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.Note: The parameter value cannot be data of a complex type such as HTML. Example: {"name":"xxx","age":"xx"} |
TemplateContent
Template content, which must include at least one of TEXT and HTML. A combination of TEXT and HTML is recommended.
Used by actions: CreateEmailTemplate, GetEmailTemplate, UpdateEmailTemplate.
Name | Type | Required | Description |
---|---|---|---|
Html | String | No | HTML code after base64 encoding. |
Text | String | No | Text content after base64 encoding. |
TemplatesMetadata
Template list structure.
Used by actions: ListEmailTemplates.
Name | Type | Description |
---|---|---|
CreatedTimestamp | Integer | Creation time. |
TemplateName | String | Template name. |
TemplateStatus | Integer | Template status. 1: under review; 0: approved; 2: rejected; other values: unavailable. |
TemplateID | Integer | Template ID. |
ReviewReason | String | Review reply |
TimedEmailParam
Time parameter required to create a scheduled sending task, such as the start time
Used by actions: BatchSendEmail, ListSendTasks.
Name | Type | Required | Description |
---|---|---|---|
BeginTime | String | Yes | Start time of a scheduled sending task |
Volume
Statistics structure.
Used by actions: GetStatisticsReport.
Name | Type | Description |
---|---|---|
SendDate | Date | Date Note: this field may return null , indicating that no valid values can be obtained. |
RequestCount | Integer | Number of email requests. |
AcceptedCount | Integer | Number of email requests accepted by Tencent Cloud. |
DeliveredCount | Integer | Number of delivered emails. |
OpenedCount | Integer | Number of users (deduplicated) who opened emails. |
ClickedCount | Integer | Number of recipients who clicked on links in emails. |
BounceCount | Integer | Number of bounced emails. |
UnsubscribeCount | Integer | Number of users who canceled subscriptions. Note: this field may return null , indicating that no valid values can be obtained. |
推荐阅读
-
2022 FIT2CLOUD FIT2CLOUD 开源成绩单
-
tencent cloud
-
[Spring Cloud] (5) 网关前端和后端公钥和私钥以及身份验证信息 - 前端
-
专题速递感知无损压缩、LCEVC、RTE 中的 AV1、PPA 优化和 Tencent266 编码器
-
[Spring Cloud] (4) 构建 Vue2 以与网关和微服务通信,并配置跨域 - 前端登录界面
-
Spring Cloud:JWT 加密密钥工具生成 jks 文件
-
Spring Cloud] 服务容错中间件哨兵高级版服务容错中间件哨兵高级版 - 五条规则
-
Spring Cloud Feign 的工作原理、负载平衡和使用示例
-
Testin Cloud Test 推出华为 Pura 70 系列真实世界测试服务!
-
Adobe Creative Cloud 摄影课程,观看并节省 ¥888/ 年-产品技能认证