tencentcloud-sdk-nodejs-ses 4.1.181 → 4.1.187

package/es/services/ses/v20201002/ses_client.js

@@ -30,8 +30,8 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async UpdateCustomBlackList(req, cb) {
         return this.request("UpdateCustomBlackList", req, cb);
     }
-    async ListBlackEmailAddress(req, cb) {
-        return this.request("ListBlackEmailAddress", req, cb);
+    async GetStatisticsReport(req, cb) {
+        return this.request("GetStatisticsReport", req, cb);
     }
     async CreateAddressUnsubscribeConfig(req, cb) {
         return this.request("CreateAddressUnsubscribeConfig", req, cb);
@@ -93,11 +93,14 @@ export class Client extends TencentCloudCommon.AbstractClient {
     async SendEmail(req, cb) {
         return this.request("SendEmail", req, cb);
     }
+    async GetAbuseReport(req, cb) {
+        return this.request("GetAbuseReport", req, cb);
+    }
     async ListCustomBlacklist(req, cb) {
         return this.request("ListCustomBlacklist", req, cb);
     }
-    async GetStatisticsReport(req, cb) {
-        return this.request("GetStatisticsReport", req, cb);
+    async ListBlackEmailAddress(req, cb) {
+        return this.request("ListBlackEmailAddress", req, cb);
     }
     async CreateReceiverDetail(req, cb) {
         return this.request("CreateReceiverDetail", req, cb);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-ses",
-  "version": "4.1.181",
+  "version": "4.1.187",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",

package/tencentcloud/services/ses/v20201002/ses_client.d.ts

@@ -1,5 +1,5 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { ListAddressUnsubscribeConfigRequest, BatchSendEmailResponse, DeleteEmailIdentityRequest, CreateCustomBlacklistResponse, UpdateAddressUnsubscribeConfigResponse, CreateReceiverRequest, CreateEmailAddressRequest, CreateReceiverDetailRequest, UpdateEmailTemplateResponse, CreateReceiverDetailWithDataRequest, GetEmailTemplateResponse, ListAddressUnsubscribeConfigResponse, SendEmailRequest, UpdateEmailIdentityRequest, DeleteEmailIdentityResponse, DeleteEmailTemplateResponse, ListCustomBlacklistRequest, DeleteEmailTemplateRequest, ListEmailTemplatesRequest, DeleteBlackListRequest, ListBlackEmailAddressResponse, ListEmailIdentitiesResponse, UpdateCustomBlackListRequest, UpdateEmailSmtpPassWordRequest, DeleteCustomBlackListRequest, UpdateAddressUnsubscribeConfigRequest, ListEmailIdentitiesRequest, CreateReceiverResponse, UpdateEmailSmtpPassWordResponse, ListReceiversRequest, GetEmailIdentityResponse, ListSendTasksRequest, ListReceiverDetailsResponse, ListEmailTemplatesResponse, GetEmailIdentityRequest, GetStatisticsReportRequest, GetSendEmailStatusResponse, CreateEmailIdentityRequest, UpdateEmailTemplateRequest, CreateEmailTemplateRequest, DeleteBlackListResponse, DeleteCustomBlackListResponse, DeleteAddressUnsubscribeConfigRequest, CreateReceiverDetailResponse, DeleteReceiverResponse, SendEmailResponse, GetStatisticsReportResponse, DeleteEmailAddressResponse, ListCustomBlacklistResponse, ListReceiverDetailsRequest, CreateEmailIdentityResponse, CreateEmailAddressResponse, DeleteAddressUnsubscribeConfigResponse, BatchSendEmailRequest, CreateCustomBlacklistRequest, ListEmailAddressRequest, UpdateCustomBlackListResponse, ListBlackEmailAddressRequest, CreateReceiverDetailWithDataResponse, GetEmailTemplateRequest, ListSendTasksResponse, CreateAddressUnsubscribeConfigRequest, UpdateEmailIdentityResponse, CreateEmailTemplateResponse, GetSendEmailStatusRequest, ListEmailAddressResponse, DeleteEmailAddressRequest, DeleteReceiverRequest, CreateAddressUnsubscribeConfigResponse, ListReceiversResponse } from "./ses_models";
+import { ListAddressUnsubscribeConfigRequest, BatchSendEmailResponse, DeleteEmailIdentityRequest, CreateCustomBlacklistResponse, UpdateAddressUnsubscribeConfigResponse, CreateReceiverRequest, CreateEmailAddressRequest, CreateReceiverDetailRequest, UpdateEmailTemplateResponse, CreateReceiverDetailWithDataRequest, ListAddressUnsubscribeConfigResponse, SendEmailRequest, UpdateEmailIdentityRequest, DeleteEmailIdentityResponse, DeleteBlackListRequest, DeleteEmailTemplateResponse, ListCustomBlacklistRequest, DeleteEmailTemplateRequest, ListEmailTemplatesRequest, GetAbuseReportResponse, ListBlackEmailAddressResponse, ListEmailIdentitiesResponse, UpdateCustomBlackListRequest, UpdateEmailSmtpPassWordRequest, DeleteCustomBlackListRequest, UpdateAddressUnsubscribeConfigRequest, ListEmailIdentitiesRequest, GetEmailTemplateResponse, CreateReceiverResponse, UpdateEmailSmtpPassWordResponse, ListReceiversRequest, GetEmailIdentityResponse, ListSendTasksRequest, ListReceiverDetailsResponse, ListEmailTemplatesResponse, GetEmailIdentityRequest, GetStatisticsReportRequest, GetSendEmailStatusResponse, CreateEmailIdentityRequest, UpdateEmailTemplateRequest, CreateEmailTemplateRequest, DeleteBlackListResponse, DeleteCustomBlackListResponse, DeleteAddressUnsubscribeConfigRequest, CreateReceiverDetailResponse, DeleteReceiverResponse, SendEmailResponse, GetStatisticsReportResponse, DeleteEmailAddressResponse, ListCustomBlacklistResponse, ListReceiverDetailsRequest, CreateEmailIdentityResponse, CreateEmailAddressResponse, GetAbuseReportRequest, DeleteAddressUnsubscribeConfigResponse, BatchSendEmailRequest, CreateCustomBlacklistRequest, ListEmailAddressRequest, UpdateCustomBlackListResponse, ListBlackEmailAddressRequest, CreateReceiverDetailWithDataResponse, GetEmailTemplateRequest, ListSendTasksResponse, CreateAddressUnsubscribeConfigRequest, UpdateEmailIdentityResponse, CreateEmailTemplateResponse, GetSendEmailStatusRequest, ListEmailAddressResponse, DeleteEmailAddressRequest, DeleteReceiverRequest, CreateAddressUnsubscribeConfigResponse, ListReceiversResponse } from "./ses_models";
 /**
  * ses client
  * @class
@@ -43,9 +43,9 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      */
     UpdateCustomBlackList(req: UpdateCustomBlackListRequest, cb?: (error: string, rep: UpdateCustomBlackListResponse) => void): Promise<UpdateCustomBlackListResponse>;
     /**
-     * 腾讯云发送的邮件一旦被收件方判断为硬退(Hard Bounce)，腾讯云会拉黑该地址，并不允许所有用户向该地址发送邮件。成为邮箱黑名单。如果业务方确认是误判，可以从黑名单中删除。
+     * 获取近期发送的统计情况，包含发送量、送达率、打开率、退信率等一系列数据。
      */
-    ListBlackEmailAddress(req: ListBlackEmailAddressRequest, cb?: (error: string, rep: ListBlackEmailAddressResponse) => void): Promise<ListBlackEmailAddressResponse>;
+    GetStatisticsReport(req: GetStatisticsReportRequest, cb?: (error: string, rep: GetStatisticsReportResponse) => void): Promise<GetStatisticsReportResponse>;
     /**
      * 创建地址级退订配置
      */
@@ -127,14 +127,18 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      * 您可以通过此API发送HTML或者TEXT邮件，适用于触发类邮件（验证码、交易类）。默认仅支持使用模板发送邮件。
      */
     SendEmail(req: SendEmailRequest, cb?: (error: string, rep: SendEmailResponse) => void): Promise<SendEmailResponse>;
+    /**
+     * 获取垃圾投诉数据
+     */
+    GetAbuseReport(req: GetAbuseReportRequest, cb?: (error: string, rep: GetAbuseReportResponse) => void): Promise<GetAbuseReportResponse>;
     /**
      * 获取自定义黑名单列表
      */
     ListCustomBlacklist(req: ListCustomBlacklistRequest, cb?: (error: string, rep: ListCustomBlacklistResponse) => void): Promise<ListCustomBlacklistResponse>;
     /**
-     * 获取近期发送的统计情况，包含发送量、送达率、打开率、退信率等一系列数据。
+     * 腾讯云发送的邮件一旦被收件方判断为硬退(Hard Bounce)，腾讯云会拉黑该地址，并不允许所有用户向该地址发送邮件。成为邮箱黑名单。如果业务方确认是误判，可以从黑名单中删除。
      */
-    GetStatisticsReport(req: GetStatisticsReportRequest, cb?: (error: string, rep: GetStatisticsReportResponse) => void): Promise<GetStatisticsReportResponse>;
+    ListBlackEmailAddress(req: ListBlackEmailAddressRequest, cb?: (error: string, rep: ListBlackEmailAddressResponse) => void): Promise<ListBlackEmailAddressResponse>;
     /**
      * 在创建完收件人列表后，向这个收件人列表中批量增加收件人邮箱地址，一次最大支持2万，异步完成处理。数据量比较大的时候，上传可能需要一点时间，可以通过查询收件人列表了解上传状态和上传数量。本接口与接口CreateReceiverDetailWithData的功能特性基本一致，只是不支持上传发信时的模板参数。用户首先调用创建收件人列表接口-CreateReceiver后，然后调用本接口传入收件人地址，最后使用批量发送邮件接口-BatchSendEmail，即可完成批量发信。本接口也支持追加收件人地址，也不支持去重，需要用户自己保证收件人地址不重复。本接口一次请求的收件人地址数量限制为2W条，但收件人列表中收件人地址的总量不能超过一定的数量，目前是限制5万条。
      */

package/tencentcloud/services/ses/v20201002/ses_client.js

@@ -83,10 +83,10 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("UpdateCustomBlackList", req, cb);
     }
     /**
-     * 腾讯云发送的邮件一旦被收件方判断为硬退(Hard Bounce)，腾讯云会拉黑该地址，并不允许所有用户向该地址发送邮件。成为邮箱黑名单。如果业务方确认是误判，可以从黑名单中删除。
+     * 获取近期发送的统计情况，包含发送量、送达率、打开率、退信率等一系列数据。
      */
-    async ListBlackEmailAddress(req, cb) {
-        return this.request("ListBlackEmailAddress", req, cb);
+    async GetStatisticsReport(req, cb) {
+        return this.request("GetStatisticsReport", req, cb);
     }
     /**
      * 创建地址级退订配置
@@ -209,6 +209,12 @@ class Client extends TencentCloudCommon.AbstractClient {
     async SendEmail(req, cb) {
         return this.request("SendEmail", req, cb);
     }
+    /**
+     * 获取垃圾投诉数据
+     */
+    async GetAbuseReport(req, cb) {
+        return this.request("GetAbuseReport", req, cb);
+    }
     /**
      * 获取自定义黑名单列表
      */
@@ -216,10 +222,10 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("ListCustomBlacklist", req, cb);
     }
     /**
-     * 获取近期发送的统计情况，包含发送量、送达率、打开率、退信率等一系列数据。
+     * 腾讯云发送的邮件一旦被收件方判断为硬退(Hard Bounce)，腾讯云会拉黑该地址，并不允许所有用户向该地址发送邮件。成为邮箱黑名单。如果业务方确认是误判，可以从黑名单中删除。
      */
-    async GetStatisticsReport(req, cb) {
-        return this.request("GetStatisticsReport", req, cb);
+    async ListBlackEmailAddress(req, cb) {
+        return this.request("ListBlackEmailAddress", req, cb);
     }
     /**
      * 在创建完收件人列表后，向这个收件人列表中批量增加收件人邮箱地址，一次最大支持2万，异步完成处理。数据量比较大的时候，上传可能需要一点时间，可以通过查询收件人列表了解上传状态和上传数量。本接口与接口CreateReceiverDetailWithData的功能特性基本一致，只是不支持上传发信时的模板参数。用户首先调用创建收件人列表接口-CreateReceiver后，然后调用本接口传入收件人地址，最后使用批量发送邮件接口-BatchSendEmail，即可完成批量发信。本接口也支持追加收件人地址，也不支持去重，需要用户自己保证收件人地址不重复。本接口一次请求的收件人地址数量限制为2W条，但收件人列表中收件人地址的总量不能超过一定的数量，目前是限制5万条。

package/tencentcloud/services/ses/v20201002/ses_models.d.ts

@@ -317,25 +317,91 @@ export interface DNSAttributes {
     Status?: boolean;
 }
 /**
- * GetEmailTemplate返回参数结构体
+ * 描述邮件发送状态
  */
-export interface GetEmailTemplateResponse {
+export interface SendEmailStatus {
     /**
-     * 模板内容数据
+     * SendEmail返回的MessageId
      */
-    TemplateContent: TemplateContent;
+    MessageId?: string;
     /**
-     * 模板状态 0-审核通过 1-待审核 2-审核拒绝
+     * 收件人邮箱
      */
-    TemplateStatus: number;
+    ToEmailAddress?: string;
     /**
-     * 模板名称
+     * 发件人邮箱
      */
-    TemplateName: string;
+    FromEmailAddress?: string;
     /**
-     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     * 腾讯云处理状态
+  0: 处理成功
+  1001: 内部系统异常
+  1002: 内部系统异常
+  1003: 内部系统异常
+  1003: 内部系统异常
+  1004: 发信超时
+  1005: 内部系统异常
+  1006: 触发频率控制，短时间内对同一地址发送过多邮件
+  1007: 邮件地址在黑名单中
+  1008: 域名被收件人拒收
+  1009: 内部系统异常
+  1010: 超出了每日发送限制
+  1011: 无发送自定义内容权限，必须使用模板
+  1013: 域名被收件人取消订阅
+  2001: 找不到相关记录
+  3007: 模板ID无效或者不可用
+  3008: 被收信域名临时封禁
+  3009: 无权限使用该模板
+  3010: TemplateData字段格式不正确
+  3014: 发件域名没有经过认证，无法发送
+  3020: 收件方邮箱类型在黑名单
+  3024: 邮箱地址格式预检查失败
+  3030: 退信率过高，临时限制发送
+  3033: 余额不足，账号欠费等
      */
-    RequestId?: string;
+    SendStatus?: number;
+    /**
+     * 收件方处理状态
+  0: 请求成功被腾讯云接受，进入发送队列
+  1: 邮件递送成功，DeliverTime表示递送成功的时间
+  2: 邮件因某种原因被丢弃，DeliverMessage表示丢弃原因
+  3: 收件方ESP拒信，一般原因为邮箱地址不存在，或其它原因
+  8: 邮件被ESP因某些原因延迟递送，DeliverMessage表示延迟原因
+     */
+    DeliverStatus?: number;
+    /**
+     * 收件方处理状态描述
+     */
+    DeliverMessage?: string;
+    /**
+     * 请求到达腾讯云时间戳
+     */
+    RequestTime?: number;
+    /**
+     * 腾讯云执行递送时间戳
+     */
+    DeliverTime?: number;
+    /**
+     * 用户是否打开该邮件
+     */
+    UserOpened?: boolean;
+    /**
+     * 用户是否点击该邮件中的链接
+     */
+    UserClicked?: boolean;
+    /**
+     * 用户是否取消该发送者的订阅
+     */
+    UserUnsubscribed?: boolean;
+    /**
+     * 用户是否举报该发送者
+     * @deprecated
+     */
+    UserComplainted?: boolean;
+    /**
+     * 用户是否举报该发送者
+     */
+    UserComplained?: boolean;
 }
 /**
  * ListAddressUnsubscribeConfig返回参数结构体
@@ -436,6 +502,15 @@ export interface DeleteEmailIdentityResponse {
      */
     RequestId?: string;
 }
+/**
+ * DeleteBlackList请求参数结构体
+ */
+export interface DeleteBlackListRequest {
+    /**
+     * 需要清除的黑名单邮箱列表，数组长度至少为1
+     */
+    EmailAddressList: Array<string>;
+}
 /**
  * DeleteEmailTemplate返回参数结构体
  */
@@ -476,91 +551,61 @@ export interface DeleteEmailTemplateRequest {
     TemplateID: number;
 }
 /**
- * 描述邮件发送状态
+ * 垃圾投诉数据
  */
-export interface SendEmailStatus {
+export interface AbuseReport {
     /**
-     * SendEmail返回的MessageId
+     * 发送时间
      */
-    MessageId?: string;
+    DeliverTime?: string;
     /**
-     * 收件人邮箱
+     * 发信地址
      */
-    ToEmailAddress?: string;
+    OriginalMailFrom?: string;
     /**
-     * 发件人邮箱
+     * 收信地址
      */
-    FromEmailAddress?: string;
+    OriginalRcptTo?: string;
     /**
-     * 腾讯云处理状态
-  0: 处理成功
-  1001: 内部系统异常
-  1002: 内部系统异常
-  1003: 内部系统异常
-  1003: 内部系统异常
-  1004: 发信超时
-  1005: 内部系统异常
-  1006: 触发频率控制，短时间内对同一地址发送过多邮件
-  1007: 邮件地址在黑名单中
-  1008: 域名被收件人拒收
-  1009: 内部系统异常
-  1010: 超出了每日发送限制
-  1011: 无发送自定义内容权限，必须使用模板
-  1013: 域名被收件人取消订阅
-  2001: 找不到相关记录
-  3007: 模板ID无效或者不可用
-  3008: 被收信域名临时封禁
-  3009: 无权限使用该模板
-  3010: TemplateData字段格式不正确
-  3014: 发件域名没有经过认证，无法发送
-  3020: 收件方邮箱类型在黑名单
-  3024: 邮箱地址格式预检查失败
-  3030: 退信率过高，临时限制发送
-  3033: 余额不足，账号欠费等
+     * 发信域名
      */
-    SendStatus?: number;
+    FromDomain?: string;
     /**
-     * 收件方处理状态
-  0: 请求成功被腾讯云接受，进入发送队列
-  1: 邮件递送成功，DeliverTime表示递送成功的时间
-  2: 邮件因某种原因被丢弃，DeliverMessage表示丢弃原因
-  3: 收件方ESP拒信，一般原因为邮箱地址不存在，或其它原因
-  8: 邮件被ESP因某些原因延迟递送，DeliverMessage表示延迟原因
+     * 投诉时间
      */
-    DeliverStatus?: number;
+    ComplainTime?: string;
     /**
-     * 收件方处理状态描述
+     * 收信域名
      */
-    DeliverMessage?: string;
+    Mta?: string;
     /**
-     * 请求到达腾讯云时间戳
+     * 来源ip
      */
-    RequestTime?: number;
+    SourceIp?: string;
     /**
-     * 腾讯云执行递送时间戳
+     * 数据时间
      */
-    DeliverTime?: number;
+    InsertTime?: string;
     /**
-     * 用户是否打开该邮件
+     * 模板id
      */
-    UserOpened?: boolean;
+    TemplateId?: string;
     /**
-     * 用户是否点击该邮件中的链接
+     * bulkId
      */
-    UserClicked?: boolean;
+    BulkId?: string;
     /**
-     * 用户是否取消该发送者的订阅
+     * 邮件Message-Id
      */
-    UserUnsubscribed?: boolean;
+    MessageId?: string;
     /**
-     * 用户是否举报该发送者
-     * @deprecated
+     * 投诉时间
      */
-    UserComplainted?: boolean;
+    AbuseTime?: string;
     /**
-     * 用户是否举报该发送者
+     * 邮件主题
      */
-    UserComplained?: boolean;
+    Subject?: string;
 }
 /**
  * ListEmailTemplates请求参数结构体
@@ -576,13 +621,21 @@ export interface ListEmailTemplatesRequest {
     Offset: number;
 }
 /**
- * DeleteBlackList请求参数结构体
+ * GetAbuseReport返回参数结构体
  */
-export interface DeleteBlackListRequest {
+export interface GetAbuseReportResponse {
     /**
-     * 需要清除的黑名单邮箱列表，数组长度至少为1
+     * 打开日志数据
      */
-    EmailAddressList: Array<string>;
+    Data?: Array<AbuseReport>;
+    /**
+     * 总条数
+     */
+    TotalCount?: number;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
 }
 /**
  * 收件人明细输入参数，包含收件人邮箱，以及模板参数
@@ -742,6 +795,27 @@ export interface ListEmailIdentitiesRequest {
      */
     Offset?: number;
 }
+/**
+ * GetEmailTemplate返回参数结构体
+ */
+export interface GetEmailTemplateResponse {
+    /**
+     * 模板内容数据
+     */
+    TemplateContent: TemplateContent;
+    /**
+     * 模板状态 0-审核通过 1-待审核 2-审核拒绝
+     */
+    TemplateStatus: number;
+    /**
+     * 模板名称
+     */
+    TemplateName: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * CreateReceiver返回参数结构体
  */
@@ -1231,6 +1305,47 @@ export interface CreateEmailAddressResponse {
      */
     RequestId?: string;
 }
+/**
+ * GetAbuseReport请求参数结构体
+ */
+export interface GetAbuseReportRequest {
+    /**
+     * 起始时间
+     */
+    StartTime: string;
+    /**
+     * 结束时间
+     */
+    EndTime: string;
+    /**
+     * 偏移量
+     */
+    Offset?: number;
+    /**
+     * 限制数量（默认为1000）
+     */
+    Limit?: number;
+    /**
+     * 发信域名
+     */
+    FromDomain?: string;
+    /**
+     * 发信地址
+     */
+    FromAddress?: string;
+    /**
+     * 收信域名
+     */
+    Mta?: string;
+    /**
+     * 收信地址
+     */
+    ToAddress?: string;
+    /**
+     * 模版id
+     */
+    TemplateId?: string;
+}
 /**
  * DeleteAddressUnsubscribeConfig返回参数结构体
  */