tencentcloud-sdk-ess 3.0.659 → 3.0.660

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: efc4c0633580ab9b74dbd7f13cd53b701ff8ea6f
-  data.tar.gz: 9f433efe62a9562e0bcb92a387f90be00227e524
+  metadata.gz: 9eed30651867f40a38aa3196b66dabb8e2515a2b
+  data.tar.gz: 961e2478e0a7529f550a907ed111e5f2b7427354
 SHA512:
-  metadata.gz: 7626bc5059f0a2f9905e7f31d36a76252718c3e4a2f4bdcdfb71ba376286f6f5e3266c011f40a64699ec5b801841270d8443693a1e23adee0ca789e59b18dc1d
-  data.tar.gz: c2825ba3fdd0513c9ba379632138183e793d6a9131cc9217674f500de494691e04221ce23b3383a08fa43018458f7cf944bdb06945d5283668bda785f5ff2b5c
+  metadata.gz: 0823a3c206f92087891e07317f92aeb3640e3adfe01012b76028820f66b9b27b8a7ee554b469a32a1badeae7d724e6052ff01812321a0f1dfb934700904248ac
+  data.tar.gz: 2813e4efbb3c840c2fd89654bf4f9791cd1193fc47b82a6cf086da6b0e4ca93a71a9df3fcde8bcce7a6ae3e7b0f763ded7929aae21affee8a719989e15e7745b

data/lib/VERSION

@@ -1 +1 @@
-3.0.659
+3.0.660

data/lib/v20201111/client.rb

@@ -218,7 +218,14 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口（CreateEmbedWebUrl）用于创建嵌入web的链接 本接口支持创建：创建印章，创建模板，修改模板，预览模板，预览合同流程的web链接 进入web连接后与当前控制台操作保持一致
+        # 本接口（CreateEmbedWebUrl）用于创建嵌入Web的链接，支持以下类型的Web链接创建：
+        # 1. 创建印章
+        # 2. 创建模板
+        # 3. 修改模板
+        # 4. 预览模板
+        # 5. 预览合同流程
+
+        # 用户可以通过这些链接快速将其集成到自己的系统中。
 
         # @param request: Request instance for CreateEmbedWebUrl.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateEmbedWebUrlRequest`
@@ -271,12 +278,13 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # ### 适用场景
-        # 在通过模板或者文件发起合同时，若未指定企业签署人信息，则流程发起后，可以调用此接口补充或签签署人。
-        # 同一签署人可以补充多个员工作为或签签署人,最终实际签署人取决于谁先领取合同完成签署。
-        # ### 限制条件
-        # -  本企业(发起方企业)支持通过企业微信UserId 或者 姓名+手机号补充
-        # - 他方企业仅支持通过姓名+手机号补充
+        # 适用场景：
+        # 当通过模板或文件发起合同时，若未指定企业签署人信息，则可调用此接口补充或添加签署人。同一签署人可补充多个员工作为或签署人，最终实际签署人取决于谁先领取合同完成签署。
+
+        # 限制条件：
+        # 1. 本企业（发起方企业）企业微信签署人仅支持通过企业微信UserId或姓名+手机号进行补充。
+        # 2. 本企业（发起方企业）非企业微信签署人仅支持通过姓名+手机号进行补充。
+        # 3. 他方企业仅支持通过姓名+手机号进行补充。
 
         # @param request: Request instance for CreateFlowApprovers.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowApproversRequest`
@@ -387,8 +395,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 此接口（CreateFlowGroupByTemplates）通过多模板创建合同组签署流程。<br/>
-        # 此接口合同组中的子合同必须都是模板发起的合同。 <br/>目前最大仅支持50个子合同
+        # 此接口（CreateFlowGroupByTemplates）可用于通过多个模板创建合同组签署流程。
+
+        # 适用场景：该接口适用于需要一次性完成多份合同签署的情况，多份合同一般具有关联性，用户以目录的形式查看合同。
 
         # @param request: Request instance for CreateFlowGroupByTemplates.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateFlowGroupByTemplatesRequest`
@@ -582,7 +591,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 绑定员工与对应角色
+        # 此接口用于赋予员工指定的角色权限，如需解绑请使用 DeleteIntegrationRoleUsers 接口。
 
         # @param request: Request instance for CreateIntegrationUserRoles.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreateIntegrationUserRolesRequest`
@@ -676,7 +685,11 @@ module TencentCloud
 
         # ![image](https://dyn.ess.tencent.cn/guide/capi/CreatePersonAuthCertificateImage.png)
 
-        # 注:  `只能获取个人用户证明图片, 企业员工的暂不支持`
+        # 注:
+        # <ul>
+        # <li>只能获取个人用户证明图片, 企业员工的暂不支持</li>
+        # <li>处方单等特殊场景专用，此接口为白名单功能，使用前请联系对接的客户经理沟通。  </li>
+        # </ul>
 
         # @param request: Request instance for CreatePersonAuthCertificateImage.
         # @type request: :class:`Tencentcloud::ess::V20201111::CreatePersonAuthCertificateImageRequest`
@@ -972,7 +985,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 解绑员工与对应角色关系
+        # 解绑员工与对应角色的关系，如需绑定请使用 CreateIntegrationUserRoles 接口。
 
         # @param request: Request instance for DeleteIntegrationRoleUsers.
         # @type request: :class:`Tencentcloud::ess::V20201111::DeleteIntegrationRoleUsersRequest`
@@ -1266,33 +1279,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 集团企业统一使用主代子进行操作，无需根据子企业账号进行转化查询，该接口需要屏蔽下线
-
-        # 通过子企业影子账号查询主企业员工账号
-
-        # @param request: Request instance for DescribeIntegrationMainOrganizationUser.
-        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationMainOrganizationUserRequest`
-        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationMainOrganizationUserResponse`
-        def DescribeIntegrationMainOrganizationUser(request)
-          body = send_request('DescribeIntegrationMainOrganizationUser', request.serialize)
-          response = JSON.parse(body)
-          if response['Response'].key?('Error') == false
-            model = DescribeIntegrationMainOrganizationUserResponse.new
-            model.deserialize(response['Response'])
-            model
-          else
-            code = response['Response']['Error']['Code']
-            message = response['Response']['Error']['Message']
-            reqid = response['Response']['RequestId']
-            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
-          end
-        rescue TencentCloud::Common::TencentCloudSDKException => e
-          raise e
-        rescue StandardError => e
-          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
-        end
+        # 此接口（DescribeIntegrationRoles）用于分页查询企业角色列表，列表按照角色创建时间升序排列。
 
-        # 分页查询企业角色列表，法人的角色是系统保留角色，不会返回，按照角色创建时间升序排列
+        # 注：`法人角色是系统保留角色，因此返回列表中不含法人角色。`
 
         # @param request: Request instance for DescribeIntegrationRoles.
         # @type request: :class:`Tencentcloud::ess::V20201111::DescribeIntegrationRolesRequest`

data/lib/v20201111/models.rb

@@ -1245,21 +1245,21 @@ module TencentCloud
         # @param Operator: 执行本接口操作的员工信息。
         # <br/>注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param EmbedType: WEB嵌入资源类型。
-        # <br/>CREATE_SEAL: 生成创建印章的嵌入页面
-        # <br/>CREATE_TEMPLATE：生成创建模板的嵌入页面
-        # <br/>MODIFY_TEMPLATE：生成编辑模板的嵌入页面
-        # <br/>PREVIEW_TEMPLATE：生成预览模板的嵌入页面
-        # <br/>PREVIEW_SEAL_LIST：生成预览印章列表的嵌入页面
-        # <br/>PREVIEW_SEAL_DETAIL：生成预览印章详情的嵌入页面
-        # <br/>EXTEND_SERVICE：生成拓展服务的嵌入页面
-        # <br/>PREVIEW_FLOW：生成预览合同的嵌入页面
-        # <br/>PREVIEW_FLOW_DETAIL：生成查看合同详情的嵌入页面
+        # @param EmbedType: WEB嵌入资源类型，支持以下类型
+        # <ul><li>CREATE_SEAL: 生成创建印章的嵌入页面</li>
+        # <li>CREATE_TEMPLATE：生成创建模板的嵌入页面</li>
+        # <li>MODIFY_TEMPLATE：生成编辑模板的嵌入页面</li>
+        # <li>PREVIEW_TEMPLATE：生成预览模板的嵌入页面</li>
+        # <li>PREVIEW_SEAL_LIST：生成预览印章列表的嵌入页面</li>
+        # <li>PREVIEW_SEAL_DETAIL：生成预览印章详情的嵌入页面</li>
+        # <li>EXTEND_SERVICE：生成拓展服务的嵌入页面</li>
+        # <li>PREVIEW_FLOW：生成预览合同的嵌入页面</li>
+        # <li>PREVIEW_FLOW_DETAIL：生成查看合同详情的嵌入页面</li></ul>
         # @type EmbedType: String
         # @param BusinessId: WEB嵌入的业务资源ID
-        # <br/>PREVIEW_SEAL_DETAIL，必填，取值为印章id
-        # <br/>MODIFY_TEMPLATE，PREVIEW_TEMPLATE，必填，取值为模板id
-        # <br/>PREVIEW_FLOW，PREVIEW_FLOW_DETAIL，必填，取值为合同id
+        # <ul><li>PREVIEW_SEAL_DETAIL，必填，取值为印章id</li>
+        # <li>MODIFY_TEMPLATE，PREVIEW_TEMPLATE，必填，取值为模板id</li>
+        # <li>PREVIEW_FLOW，PREVIEW_FLOW_DETAIL，必填，取值为合同id</li><ul>
         # @type BusinessId: String
         # @param Agent: 代理企业和员工的信息。
         # <br/>在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
@@ -1325,16 +1325,23 @@ module TencentCloud
 
       # CreateFlowApprovers请求参数结构体
       class CreateFlowApproversRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowId: 签署流程编号
+        # @param FlowId: 合同流程ID，为32位字符串。
+        # 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
+        # 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         # @type FlowId: String
-        # @param Approvers: 补充签署人信息
+        # @param Approvers: 补充企业签署人信息。
+
+        # - 如果发起方指定的补充签署人是企业微信签署人（ApproverSource=WEWORKAPP），则需要提供企业微信UserId进行补充；
+
+        # - 如果不指定，则使用姓名和手机号进行补充。
         # @type Approvers: Array
-        # @param Initiator: 企微消息中的发起人
+        # @param Initiator: 在可定制的企业微信通知中，发起人可以根据具体需求进行自定义设置。
         # @type Initiator: String
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作
-
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :FlowId, :Approvers, :Initiator, :Agent
@@ -1750,15 +1757,22 @@ module TencentCloud
 
       # CreateFlowGroupByTemplates请求参数结构体
       class CreateFlowGroupByTemplatesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 调用方用户信息，userId 必填。支持填入集团子公司经办人 userId 代发合同
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param FlowGroupName: 合同组名称,最大长度200个字符
+        # @param FlowGroupName: 合同（流程）组名称（可自定义此名称），长度不能超过200，只能由中文、字母、数字和下划线组成。
         # @type FlowGroupName: String
-        # @param FlowGroupInfos: 合同组的子合同信息，支持2-50个子合同
+        # @param FlowGroupInfos: 合同（流程）组的子合同信息，支持2-50个子合同
         # @type FlowGroupInfos: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param FlowGroupOptions: 合同组的配置信息。包括是否通知本企业签署方，是否通知其他签署方
+        # @param FlowGroupOptions: 合同（流程）组的配置项信息。
+        # 其中包括：
+        # <ul>
+        # <li>是否通知本企业签署方</li>
+        # <li>是否通知其他签署方</li>
+        # </ul>
         # @type FlowGroupOptions: :class:`Tencentcloud::Ess.v20201111.models.FlowGroupOptions`
 
         attr_accessor :Operator, :FlowGroupName, :FlowGroupInfos, :Agent, :FlowGroupOptions
@@ -2493,13 +2507,13 @@ module TencentCloud
 
       # CreateIntegrationUserRoles请求参数结构体
       class CreateIntegrationUserRolesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，UserId必填
+        # @param Operator: 执行本接口操作的员工信息。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
         # @param UserIds: 绑定角色的用户id列表，不能重复，不能大于 100 个
         # @type UserIds: Array
-        # @param RoleIds: 绑定角色的角色id列表，不能重复，不能大于 100，可以通过DescribeIntegrationRoles接口获取
+        # @param RoleIds: 绑定角色的角色id列表，不能重复，不能大于 100，可以通过DescribeIntegrationRoles接口获取角色信息
         # @type RoleIds: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :UserIds, :RoleIds, :Agent
@@ -3591,7 +3605,7 @@ module TencentCloud
 
       # CreateUserAutoSignEnableUrl返回参数结构体
       class CreateUserAutoSignEnableUrlResponse < TencentCloud::Common::AbstractModel
-        # @param Url: 个人用户自动签的开通链接, 短链形式
+        # @param Url: 个人用户自动签的开通链接, 短链形式。过期时间受 `ExpiredTime` 参数控制。
         # @type Url: String
         # @param AppId: 腾讯电子签小程序的 AppID，用于其他小程序/APP等应用跳转至腾讯电子签小程序使用
 
@@ -3809,13 +3823,13 @@ module TencentCloud
 
       # DeleteIntegrationRoleUsers请求参数结构体
       class DeleteIntegrationRoleUsersRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
+        # @param Operator: 执行本接口操作的员工信息。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param RoleId: 角色id
+        # @param RoleId: 角色id，可以通过DescribeIntegrationRoles接口获取角色信息
         # @type RoleId: String
         # @param Users: 用户信息,最多 200 个用户，并且 UserId 和 OpenId 二选一，其他字段不需要传
         # @type Users: Array
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
 
         attr_accessor :Operator, :RoleId, :Users, :Agent
@@ -4675,64 +4689,30 @@ module TencentCloud
         end
       end
 
-      # DescribeIntegrationMainOrganizationUser请求参数结构体
-      class DescribeIntegrationMainOrganizationUserRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，userId必填
-        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-
-        attr_accessor :Operator
-
-        def initialize(operator=nil)
-          @Operator = operator
-        end
-
-        def deserialize(params)
-          unless params['Operator'].nil?
-            @Operator = UserInfo.new
-            @Operator.deserialize(params['Operator'])
-          end
-        end
-      end
-
-      # DescribeIntegrationMainOrganizationUser返回参数结构体
-      class DescribeIntegrationMainOrganizationUserResponse < TencentCloud::Common::AbstractModel
-        # @param IntegrationMainOrganizationUser: 主企业员工账号信息
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type IntegrationMainOrganizationUser: :class:`Tencentcloud::Ess.v20201111.models.IntegrationMainOrganizationUser`
-        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-        # @type RequestId: String
-
-        attr_accessor :IntegrationMainOrganizationUser, :RequestId
-
-        def initialize(integrationmainorganizationuser=nil, requestid=nil)
-          @IntegrationMainOrganizationUser = integrationmainorganizationuser
-          @RequestId = requestid
-        end
-
-        def deserialize(params)
-          unless params['IntegrationMainOrganizationUser'].nil?
-            @IntegrationMainOrganizationUser = IntegrationMainOrganizationUser.new
-            @IntegrationMainOrganizationUser.deserialize(params['IntegrationMainOrganizationUser'])
-          end
-          @RequestId = params['RequestId']
-        end
-      end
-
       # DescribeIntegrationRoles请求参数结构体
       class DescribeIntegrationRolesRequest < TencentCloud::Common::AbstractModel
-        # @param Operator: 操作人信息，UserId必填
+        # @param Operator: 执行本接口操作的员工信息。使用此接口时，必须填写UserId。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。
         # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
-        # @param Limit: 指定每页多少条数据，单页最大200
+        # @param Limit: 指定分页每页返回的数据条数，单页最大支持 200。
         # @type Limit: Integer
-        # @param Agent: 代理相关应用信息，如集团主企业代子企业操作的场景中ProxyOrganizationId必填
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
         # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
-        # @param Filters: 查询的关键字段:
-        # Key:"RoleType",Values:["1"]查询系统角色，Values:["2"]查询自定义角色
-        # Key:"RoleStatus",Values:["1"]查询启用角色，Values:["2"]查询禁用角色
-        # Key:"IsGroupRole"，Values:["0"]:查询非集团角色，Values:["1"]表示查询集团角色
-        # Key:"IsReturnPermissionGroup"，Values:["0"]:表示接口不返回角色对应的权限树字段，Values:["1"]表示接口返回角色对应的权限树字段
+        # @param Filters: 查询的关键字段，支持Key-Value单值查询。可选键值对如下：
+        # <ul>
+        #   <li>Key:"RoleType"，查询角色类型，Values可选：
+        #     <ul><li>**"1"**：查询系统角色</li><li>**"2"**：查询自定义角色</li></ul>
+        #   </li><li>Key:"RoleStatus"，查询角色状态，Values可选：
+        #     <ul><li>**"1"**：查询启用角色</li><li>**"2"**：查询禁用角色</li></ul>
+        #   </li><li>Key:"IsGroupRole"，是否查询集团角色，Values可选：
+        #     <ul><li>**"0"**：查询非集团角色</li><li>**"1"**：查询集团角色</li></ul>
+        #   </li><li>Key:"IsReturnPermissionGroup"，是否返回角色对应权限树，Values可选：
+        #     <ul><li>**"0"**：接口不返回角色对应的权限树字段</li><li>**"1"**：接口返回角色对应的权限树字段</li></ul>
+        #   </li>
+        # </ul>
         # @type Filters: Array
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大2000
+        # @param Offset: 指定分页返回第几页的数据，如果不传默认返回第一页。页码从 0 开始，即首页为 0，最大2000。
         # @type Offset: Integer
 
         attr_accessor :Operator, :Limit, :Agent, :Filters, :Offset
@@ -4769,13 +4749,13 @@ module TencentCloud
 
       # DescribeIntegrationRoles返回参数结构体
       class DescribeIntegrationRolesResponse < TencentCloud::Common::AbstractModel
-        # @param Offset: 查询结果分页返回，此处指定第几页，如果不传默认从第一页返回。页码从 0 开始，即首页为 0，最大2000
+        # @param Offset: 指定分页返回的页码。页码从0开始，最大为2000。
         # @type Offset: Integer
-        # @param Limit: 指定每页多少条数据，单页最大200
+        # @param Limit: 指定分页每页返回的数据条数，单页最大支持 200。
         # @type Limit: Integer
-        # @param TotalCount: 符合查询条件的总的角色数
+        # @param TotalCount: 符合查询条件的总角色数。
         # @type TotalCount: Integer
-        # @param IntegrateRoles: 企业角色信息列表
+        # @param IntegrateRoles: 企业角色信息列表。
         # @type IntegrateRoles: Array
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -5430,21 +5410,24 @@ module TencentCloud
 
       # 补充签署人信息
       # - RecipientId 必须指定
-      # -  通过企业自定义账号ID补充签署人时，ApproverSource 和 CustomUserId 必填，ApproverSource取值：WEWORKAPP
+      # -  通过企业微信自定义账号ID补充签署人时，ApproverSource 和 CustomUserId 必填，ApproverSource取值：WEWORKAPP
       # - 通过二要素（姓名/手机号）补充签署人时，ApproverName 和 ApproverMobile 必填，ApproverSource设置为空
       class FillApproverInfo < TencentCloud::Common::AbstractModel
-        # @param RecipientId: 对应模板中的参与方ID
+        # @param RecipientId: 签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
+        # 模板发起合同时，该参数为必填项。
+        # 文件发起合同是，该参数无需传值。
+        # 如果开发者后序用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人 。
         # @type RecipientId: String
         # @param ApproverSource: 签署人来源
         # WEWORKAPP: 企业微信
         # <br/>仅【企微或签】时指定WEWORKAPP
         # @type ApproverSource: String
-        # @param CustomUserId: 企业自定义账号ID
-        # <br/>当ApproverSource为WEWORKAPP的企微或签场景下，必须指企业自有应用获取企微明文的userid
+        # @param CustomUserId: 企业微信UserId
+        # <br/>当ApproverSource为WEWORKAPP的企微或签场景下，必须指企业自有应用获取企业微信的UserId
         # @type CustomUserId: String
-        # @param ApproverName: 补充签署人姓名
+        # @param ApproverName: 补充企业签署人员工姓名
         # @type ApproverName: String
-        # @param ApproverMobile: 补充签署人手机号
+        # @param ApproverMobile: 补充企业签署人员工手机号
         # @type ApproverMobile: String
 
         attr_accessor :RecipientId, :ApproverSource, :CustomUserId, :ApproverName, :ApproverMobile
@@ -5762,9 +5745,10 @@ module TencentCloud
         # <li>港澳居民来往内地通行证号码应为9位字符串，第1位为“C”，第2位为英文字母（但“I”、“O”除外），后7位为阿拉伯数字。</li>
         # <li>港澳台居民居住证号码编码规则与中国大陆身份证相同，应为18位字符串。</li></ul>
         # @type ApproverIdCardNumber: String
-        # @param RecipientId: 签署方经办人在模板中的参与方ID
-        # <br/>模板发起合同时，该参数为必填项
-        # <br/>文件发起合同是，该参数无序传值
+        # @param RecipientId: 签署方经办人在模板中配置的参与方ID，与控件绑定，是控件的归属方，ID为32位字符串。
+        # 模板发起合同时，该参数为必填项。
+        # 文件发起合同是，该参数无需传值。
+        # 如果开发者后续用合同模板发起合同，建议保存此值，在用合同模板发起合同中需此值绑定对应的签署经办人 。
         # @type RecipientId: String
         # @param VerifyChannel: 签署意愿确认渠道，默认为WEIXINAPP:人脸识别
 
@@ -6638,33 +6622,6 @@ module TencentCloud
         end
       end
 
-      # 主企业员工账号信息
-      class IntegrationMainOrganizationUser < TencentCloud::Common::AbstractModel
-        # @param MainOrganizationId: 主企业id
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type MainOrganizationId: String
-        # @param MainUserId: 主企业员工UserId
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type MainUserId: String
-        # @param UserName: 主企业员工名
-        # 注意：此字段可能返回 null，表示取不到有效值。
-        # @type UserName: String
-
-        attr_accessor :MainOrganizationId, :MainUserId, :UserName
-
-        def initialize(mainorganizationid=nil, mainuserid=nil, username=nil)
-          @MainOrganizationId = mainorganizationid
-          @MainUserId = mainuserid
-          @UserName = username
-        end
-
-        def deserialize(params)
-          @MainOrganizationId = params['MainOrganizationId']
-          @MainUserId = params['MainUserId']
-          @UserName = params['UserName']
-        end
-      end
-
       # ModifyApplicationCallbackInfo请求参数结构体
       class ModifyApplicationCallbackInfoRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.659
+  version: 3.0.660
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-14 00:00:00.000000000 Z
+date: 2023-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common