tencentcloud-sdk-ess 3.0.1098 → 3.0.1102

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1fb10fa99f016e8f39c135e0d403f93e0ed3164a
-  data.tar.gz: 1f3ae1ecd0519be99e706889a889c843baf856d6
+  metadata.gz: f3e33857c9e5f77b963b75523a54b9ecccceb631
+  data.tar.gz: 6d17907ae772334168b0477d5617dcc9403e217d
 SHA512:
-  metadata.gz: 1fc90d9803b96f14976412b76178bb38ee5100114779e36a08dea01fc62e111740f717a8f9013963ecb66faa49d4241daf62ab7d0323bc387c0b05376dcf4f7c
-  data.tar.gz: 3caa31bc0e86628e092706d52a5ca119c3087417059ea18046cf4c0e9b53015a0e633d2ebd9b7655d6180006174814317ce509e822dd2d889d78b3e55c9a59b2
+  metadata.gz: 4db1b54b308765b8ade668f0f469a267b32591b08f11444b96a478a3f3745657d341ccdccc3ae8b17054732f7b955bdc600e651fe7ed447e67fd04327c11adc4
+  data.tar.gz: d8d911cbd0247984e60c686fc2c02cee65ec4f117376ede097fa89cdea978cdbfb510ef3e37047132dbe306244dc68d34a60829ee8788ea7112829d235d12c19

data/lib/VERSION

@@ -1 +1 @@
-3.0.1098
+3.0.1102

data/lib/v20201111/client.rb

@@ -222,6 +222,36 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 此接口（CreateBatchInformationExtractionTask）用来通过上传后的PDF资源编号来批量创建合同智能审查任务。<br/>
+
+        # 适用场景：根据合同关键词（字段名称）来提取PDF合同文件的字段结果信息。
+
+        # 注:
+        # 1. PDF格式限制大小为10M以下
+        # 2. 仅支持5个PDF文件批量发起
+
+        # @param request: Request instance for CreateBatchInformationExtractionTask.
+        # @type request: :class:`Tencentcloud::ess::V20201111::CreateBatchInformationExtractionTaskRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::CreateBatchInformationExtractionTaskResponse`
+        def CreateBatchInformationExtractionTask(request)
+          body = send_request('CreateBatchInformationExtractionTask', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateBatchInformationExtractionTaskResponse.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
+
         # 支持企业进行批量初始化操作：
 
         # 此接口存在以下限制：
@@ -2773,6 +2803,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 本接口（DescribeInformationExtractionTask）用于获取合同智能提取任务详情，包括任务的状态和提取的字段结果信息。
+
+        # @param request: Request instance for DescribeInformationExtractionTask.
+        # @type request: :class:`Tencentcloud::ess::V20201111::DescribeInformationExtractionTaskRequest`
+        # @rtype: :class:`Tencentcloud::ess::V20201111::DescribeInformationExtractionTaskResponse`
+        def DescribeInformationExtractionTask(request)
+          body = send_request('DescribeInformationExtractionTask', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeInformationExtractionTaskResponse.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
+
         # 此接口（DescribeIntegrationDepartments）用于查询企业的部门信息列表，支持查询单个部门节点或单个部门节点及一级子节点部门列表。
 
         # @param request: Request instance for DescribeIntegrationDepartments.

data/lib/v20201111/models.rb

@@ -1668,6 +1668,81 @@ module TencentCloud
         end
       end
 
+      # CreateBatchInformationExtractionTask请求参数结构体
+      class CreateBatchInformationExtractionTaskRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行合同智能提取的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param ResourceIds: 合同智能提取的PDF文件资源编号列表，通过[UploadFiles](https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles)接口获取PDF文件资源编号。  注:  `目前，此接口仅支持5个文件发起。每个文件限制在10M以下`
+        # @type ResourceIds: Array
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param FieldTemplateId: 用户配置的合同智能提取字段模板ID，会基于此模板批量创建合同智能提取任务，为32位字符串。
+        # [点击查看模板Id在控制台上的位置](https://qcloudimg.tencent-cloud.cn/raw/99008608577532423ea437c7fdbedca1.png)
+
+        # 注:  `此配置优先级最高，设置了模板ID后Fields配置就会无效`
+        # @type FieldTemplateId: String
+        # @param Fields: 用于合同智能提取的字段信息。
+
+        # 注意：`字段模板优先级最高，如果设置了FieldTemplateId值，此配置就无效`
+        # @type Fields: Array
+
+        attr_accessor :Operator, :ResourceIds, :Agent, :FieldTemplateId, :Fields
+
+        def initialize(operator=nil, resourceids=nil, agent=nil, fieldtemplateid=nil, fields=nil)
+          @Operator = operator
+          @ResourceIds = resourceids
+          @Agent = agent
+          @FieldTemplateId = fieldtemplateid
+          @Fields = fields
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          @ResourceIds = params['ResourceIds']
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @FieldTemplateId = params['FieldTemplateId']
+          unless params['Fields'].nil?
+            @Fields = []
+            params['Fields'].each do |i|
+              extractionfield_tmp = ExtractionField.new
+              extractionfield_tmp.deserialize(i)
+              @Fields << extractionfield_tmp
+            end
+          end
+        end
+      end
+
+      # CreateBatchInformationExtractionTask返回参数结构体
+      class CreateBatchInformationExtractionTaskResponse < TencentCloud::Common::AbstractModel
+        # @param TaskIds: 合同智能提取的任务ID列表，每个任务ID为32位字符串。
+        # 建议开发者保存此任务ID，后续查询合同智能提取详情需要此任务ID。
+
+        # 注意：`返回的索引和ResourceIds数组一致`
+        # @type TaskIds: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TaskIds, :RequestId
+
+        def initialize(taskids=nil, requestid=nil)
+          @TaskIds = taskids
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TaskIds = params['TaskIds']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateBatchInitOrganizationUrl请求参数结构体
       class CreateBatchInitOrganizationUrlRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -8641,6 +8716,83 @@ module TencentCloud
         end
       end
 
+      # DescribeInformationExtractionTask请求参数结构体
+      class DescribeInformationExtractionTaskRequest < TencentCloud::Common::AbstractModel
+        # @param Operator: 执行本接口操作的员工信息。
+        # 注: `在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。`
+        # @type Operator: :class:`Tencentcloud::Ess.v20201111.models.UserInfo`
+        # @param Agent: 代理企业和员工的信息。
+        # 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。
+        # @type Agent: :class:`Tencentcloud::Ess.v20201111.models.Agent`
+        # @param TaskId: 批量创建合同智能提取任务接口返回的合同智能提取任务ID。
+        # @type TaskId: String
+
+        attr_accessor :Operator, :Agent, :TaskId
+
+        def initialize(operator=nil, agent=nil, taskid=nil)
+          @Operator = operator
+          @Agent = agent
+          @TaskId = taskid
+        end
+
+        def deserialize(params)
+          unless params['Operator'].nil?
+            @Operator = UserInfo.new
+            @Operator.deserialize(params['Operator'])
+          end
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+          @TaskId = params['TaskId']
+        end
+      end
+
+      # DescribeInformationExtractionTask返回参数结构体
+      class DescribeInformationExtractionTaskResponse < TencentCloud::Common::AbstractModel
+        # @param Fields: 信息提取任务结果
+        # @type Fields: Array
+        # @param Status: 合同智能提取任务状态。
+        # 状态如下：
+        # <ul>
+        #     <li>**0** - 任务创建成功（还未执行）</li>
+        #     <li>**1** - 排队中（等待执行）</li>
+        #     <li>**2** - 提取中（正在执行）</li>
+        #     <li>**3** - 提取成功</li>
+        #     <li>**4** - 提取失败</li>
+        # </ul>
+        # @type Status: Integer
+        # @param Url: 合同智能提取结果下载，文件格式为`xlsx`。
+
+        # 注意：`链接有效期为5分钟，过期后可重新获取`
+        # @type Url: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Fields, :Status, :Url, :RequestId
+
+        def initialize(fields=nil, status=nil, url=nil, requestid=nil)
+          @Fields = fields
+          @Status = status
+          @Url = url
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['Fields'].nil?
+            @Fields = []
+            params['Fields'].each do |i|
+              extractionfield_tmp = ExtractionField.new
+              extractionfield_tmp.deserialize(i)
+              @Fields << extractionfield_tmp
+            end
+          end
+          @Status = params['Status']
+          @Url = params['Url']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeIntegrationDepartments请求参数结构体
       class DescribeIntegrationDepartmentsRequest < TencentCloud::Common::AbstractModel
         # @param Operator: 执行本接口操作的员工信息。
@@ -9871,6 +10023,46 @@ module TencentCloud
         end
       end
 
+      # 合同智能提取字段信息
+      class ExtractionField < TencentCloud::Common::AbstractModel
+        # @param Name: 用于合同智能提取的字段名称。
+
+        # 注意: `长度不能超过30个字符`
+        # @type Name: String
+        # @param Type: 指定合同智能提取的字段类型，目前仅支持`TEXT`、`DATE`、`NUMBER`、`OPTION`类型。
+
+        # 类型支持如下：
+        # 1、TEXT（文本）
+        # 2、DATE（日期）
+        # 3、NUMBER（数字）
+        # 4、OPTION（选项值）
+        # @type Type: String
+        # @param Description: 用于描述字段信息。
+
+        # 注意：
+        # 1、`如果Type值为OPTION时，需要在字段描述中填写选项值，用,分隔`
+        # 2、描述字段不能超过100个字符
+        # @type Description: String
+        # @param Values: 提取出合同中的字段信息。
+        # @type Values: Array
+
+        attr_accessor :Name, :Type, :Description, :Values
+
+        def initialize(name=nil, type=nil, description=nil, values=nil)
+          @Name = name
+          @Type = type
+          @Description = description
+          @Values = values
+        end
+
+        def deserialize(params)
+          @Name = params['Name']
+          @Type = params['Type']
+          @Description = params['Description']
+          @Values = params['Values']
+        end
+      end
+
       # 绑定角色失败信息
       class FailedCreateRoleData < TencentCloud::Common::AbstractModel
         # @param UserId: 用户userId

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-ess
 version: !ruby/object:Gem::Version
-  version: 3.0.1098
+  version: 3.0.1102
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-10 00:00:00.000000000 Z
+date: 2025-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common