tencentcloud-sdk-python-ess 3.1.126__tar.gz → 3.1.129__tar.gz

{tencentcloud_sdk_python_ess-3.1.126 → tencentcloud_sdk_python_ess-3.1.129}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-ess
-Version: 3.1.126
+Version: 3.1.129
 Summary: Tencent Cloud Ess SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.126
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.129
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_ess-3.1.126 → tencentcloud_sdk_python_ess-3.1.129}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-ess',
-    install_requires=["tencentcloud-sdk-python-common>=3.1.126,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.129,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Ess SDK for Python',

{tencentcloud_sdk_python_ess-3.1.126 → tencentcloud_sdk_python_ess-3.1.129}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.126'
+__version__ = '3.1.129'

{tencentcloud_sdk_python_ess-3.1.126 → tencentcloud_sdk_python_ess-3.1.129}/tencentcloud/ess/v20201111/ess_client.py

@@ -701,6 +701,7 @@ class EssClient(AbstractClient):
         适用场景1：已经上传了一个word文件，希望将该word文件转换成pdf文件后发起合同
         适用场景2：已经上传了一个jpg图片文件，希望将该图片文件转换成pdf文件后发起合同<br />
         转换文件是一个耗时操作，若想查看转换任务是否完成，可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
+        <font color="red">此接口于 2026 年 12月 31 日下线</font>，请使用新接口: <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateFileConvertTask" target="_blank">新建文件转换任务（CreateFileConvertTask）</a><br />
         注:
         1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
         2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
@@ -993,6 +994,37 @@ class EssClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateFileConvertTask(self, request):
+        r"""此接口（CreateFileConvertTask）用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
+        <font color="red">原功能接口: </font><a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi" target="_blank">创建文件转换任务（CreateConvertTaskApi）</a><br />
+        前提条件：源文件已经通过 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">文件上传接口</a>完成上传，并得到了源文件的资源Id。<br />
+        适用场景1：已经上传了一个word文件，希望将该word文件转换成pdf文件后发起合同
+        适用场景2：已经上传了一个jpg图片文件，希望将该图片文件转换成pdf文件后发起合同<br />
+        转换文件是一个耗时操作，若想查看转换任务是否完成，可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFileConvertTask" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
+        注:
+        1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
+        2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
+
+        :param request: Request instance for CreateFileConvertTask.
+        :type request: :class:`tencentcloud.ess.v20201111.models.CreateFileConvertTaskRequest`
+        :rtype: :class:`tencentcloud.ess.v20201111.models.CreateFileConvertTaskResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateFileConvertTask", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateFileConvertTaskResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateFileCounterSign(self, request):
         r"""此接口用于发起数字文件CA加签操作。可以使用同步或者异步模式进行。
 
@@ -3332,6 +3364,36 @@ class EssClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeFileConvertTask(self, request):
+        r"""此接口（DescribeFileConvertTask）用来查询转换任务的状态。如需发起转换任务，请使用<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateFileConvertTask" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
+        <font color="red">原功能接口: </font><a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态（GetTaskResultApi）</a><br />
+        前提条件：已调用 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateFileConvertTask" target="_blank">创建文件转换任务接口</a>进行文件转换，并得到了返回的转换任务Id。<br />
+
+        适用场景：已创建一个文件转换任务，想查询该文件转换任务的状态，或获取转换后的文件资源Id。<br />
+        注：
+        1. `大文件转换所需的时间可能会比较长`
+        2.  `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`
+
+        :param request: Request instance for DescribeFileConvertTask.
+        :type request: :class:`tencentcloud.ess.v20201111.models.DescribeFileConvertTaskRequest`
+        :rtype: :class:`tencentcloud.ess.v20201111.models.DescribeFileConvertTaskResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeFileConvertTask", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeFileConvertTaskResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeFileCounterSignResult(self, request):
         r"""文件CA加签任务结果查询接口，用于查询 CreateFileCounterSign接口 发起的异步加签任务。
 
@@ -4124,6 +4186,7 @@ class EssClient(AbstractClient):
         前提条件：已调用 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换，并得到了返回的转换任务Id。<br />
 
         适用场景：已创建一个文件转换任务，想查询该文件转换任务的状态，或获取转换后的文件资源Id。<br />
+        <font color="red">此接口于 2026 年 12月 31 日下线</font>，请使用新接口: <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFileConvertTask" target="_blank">查询文件转换任务状态（DescribeFileConvertTask）</a><br />
         注：
         1. `大文件转换所需的时间可能会比较长`
         2.  `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`

{tencentcloud_sdk_python_ess-3.1.126 → tencentcloud_sdk_python_ess-3.1.129}/tencentcloud/ess/v20201111/ess_client_async.py

@@ -600,6 +600,7 @@ class EssClient(AbstractClient):
         适用场景1：已经上传了一个word文件，希望将该word文件转换成pdf文件后发起合同
         适用场景2：已经上传了一个jpg图片文件，希望将该图片文件转换成pdf文件后发起合同<br />
         转换文件是一个耗时操作，若想查看转换任务是否完成，可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
+        <font color="red">此接口于 2026 年 12月 31 日下线</font>，请使用新接口: <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateFileConvertTask" target="_blank">新建文件转换任务（CreateFileConvertTask）</a><br />
         注:
         1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
         2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
@@ -842,6 +843,32 @@ class EssClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def CreateFileConvertTask(
+            self,
+            request: models.CreateFileConvertTaskRequest,
+            opts: Dict = None,
+    ) -> models.CreateFileConvertTaskResponse:
+        """
+        此接口（CreateFileConvertTask）用来将word、excel、html、图片、txt类型文件转换为PDF文件。<br />
+        <font color="red">原功能接口: </font><a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi" target="_blank">创建文件转换任务（CreateConvertTaskApi）</a><br />
+        前提条件：源文件已经通过 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/UploadFiles" target="_blank">文件上传接口</a>完成上传，并得到了源文件的资源Id。<br />
+        适用场景1：已经上传了一个word文件，希望将该word文件转换成pdf文件后发起合同
+        适用场景2：已经上传了一个jpg图片文件，希望将该图片文件转换成pdf文件后发起合同<br />
+        转换文件是一个耗时操作，若想查看转换任务是否完成，可以通过<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFileConvertTask" target="_blank">查询转换任务状态</a>接口获取任务状态。<br />
+        注:
+        1. `支持的文件类型有doc、docx、xls、xlsx、html、jpg、jpeg、png、bmp、txt`
+        2. `可通过发起合同时设置预览来检查转换文件是否达到预期效果`
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateFileConvertTask"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateFileConvertTaskResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def CreateFileCounterSign(
             self,
             request: models.CreateFileCounterSignRequest,
@@ -2811,6 +2838,31 @@ class EssClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def DescribeFileConvertTask(
+            self,
+            request: models.DescribeFileConvertTaskRequest,
+            opts: Dict = None,
+    ) -> models.DescribeFileConvertTaskResponse:
+        """
+        此接口（DescribeFileConvertTask）用来查询转换任务的状态。如需发起转换任务，请使用<a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateFileConvertTask" target="_blank">创建文件转换任务接口</a>进行资源文件的转换操作<br />
+        <font color="red">原功能接口: </font><a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/GetTaskResultApi" target="_blank">查询转换任务状态（GetTaskResultApi）</a><br />
+        前提条件：已调用 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateFileConvertTask" target="_blank">创建文件转换任务接口</a>进行文件转换，并得到了返回的转换任务Id。<br />
+
+        适用场景：已创建一个文件转换任务，想查询该文件转换任务的状态，或获取转换后的文件资源Id。<br />
+        注：
+        1. `大文件转换所需的时间可能会比较长`
+        2.  `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeFileConvertTask"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeFileConvertTaskResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def DescribeFileCounterSignResult(
             self,
             request: models.DescribeFileCounterSignResultRequest,
@@ -3463,6 +3515,7 @@ class EssClient(AbstractClient):
         前提条件：已调用 <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/CreateConvertTaskApi" target="_blank">创建文件转换任务接口</a>进行文件转换，并得到了返回的转换任务Id。<br />
 
         适用场景：已创建一个文件转换任务，想查询该文件转换任务的状态，或获取转换后的文件资源Id。<br />
+        <font color="red">此接口于 2026 年 12月 31 日下线</font>，请使用新接口: <a href="https://qian.tencent.com/developers/companyApis/templatesAndFiles/DescribeFileConvertTask" target="_blank">查询文件转换任务状态（DescribeFileConvertTask）</a><br />
         注：
         1. `大文件转换所需的时间可能会比较长`
         2.  `本接口返回的文件资源ID就是PDF资源ID，可以直接用于【用PDF文件创建签署流程】接口发起合同。`