tencentcloud-sdk-essbasic 3.0.922 → 3.0.923

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a48d638efe3df16101d25f818455a893c1abf6a1
-  data.tar.gz: 4dea72727eb1ce2ef598b4f8309d72df029fb0ac
+  metadata.gz: 1d9a33c4d2ed229cf707b5ba22a62bc5107ae065
+  data.tar.gz: 7c9a918bc906103e8e52e4b04c7b5043d94c9386
 SHA512:
-  metadata.gz: e369276dc44ffb26a91bbaf03a1406fff2c855cf8305ec5076df3e628bf1eafce7e043c2060997f75bac094ad3eacfdb90364c5eb9118133562b1947841a7b6e
-  data.tar.gz: 295eef91fb6ead3db51e3d8f040f8b49605ad4223c8000443c77bfcd383bb0bb8534206904c934d56892cdf803c742a0d371855a95905d205e1d7283151b89c4
+  metadata.gz: a46cab23495adbd46edc3f7cccd760d6af87e83d5fcf8c48f7bdc817ddf3c04f4e4e20a55ae7b3914e77ddb23080b9b5ac53085953bb0a6b2ab2fde55a2df8f6
+  data.tar.gz: 71d86c053da27ecdaded16aeae19454de822712ba7657281c613ef2a5e4b0bfd0e7e67d7a0436e69f16a973f59f82623e03789b9b335c1ed8fc854217b05ff14

data/lib/VERSION

@@ -1 +1 @@
-3.0.922
+3.0.923

data/lib/v20210526/client.rb

@@ -1174,6 +1174,33 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过此接口（ChannelDescribeAccountBillDetail）查询该第三方平台子客账号计费详情。
+        # <ul>
+        # <li>对于渠道客户企业的查询，通过指定渠道企业的唯一标识(Agent.ProxyOrganizationId)来查询子客账号消耗详情</li>
+        # </ul>
+
+        # @param request: Request instance for ChannelDescribeAccountBillDetail.
+        # @type request: :class:`Tencentcloud::essbasic::V20210526::ChannelDescribeAccountBillDetailRequest`
+        # @rtype: :class:`Tencentcloud::essbasic::V20210526::ChannelDescribeAccountBillDetailResponse`
+        def ChannelDescribeAccountBillDetail(request)
+          body = send_request('ChannelDescribeAccountBillDetail', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ChannelDescribeAccountBillDetailResponse.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
+
         # 通过此接口（ChannelDescribeBillUsageDetail）查询该第三方平台子客企业的套餐消耗详情。可以支持单个子客和整个应用下所有子客的查询。
         # <ul>
         # <li>对于单个子客企业的查询，通过指定子客的唯一标识(Agent.ProxyOrganizationOpenId)来查询该子客消耗详情</li>
@@ -2562,26 +2589,20 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 管理企业扩展服务 ，企业经办人需要是企业超管或者法人。
+        # 管理企业扩展服务
 
-        # 跳转小程序的几种方式：主要是设置不同的EndPoint
-        # 1. 通过链接Url直接跳转到小程序，不需要返回
-        # 设置EndPoint为WEIXINAPP，得到链接打开即可。
+        # - **直接开通的情形：** 若在操作过程中接口没有返回跳转链接，这表明无需进行任何跳转操作。此时，相应的企业拓展服务将会直接被开通或关闭。
 
-        # 2. 客户App直接跳转到小程序-->腾讯电子签小程序操作完成-->返回App
-        # 跳转到小程序的实现，参考官方文档<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/launchApp.html">打开 App</a>
-        # 设置EndPoint为APP，得到path。
+        # - **需要法人或者超管签署开通协议的情形：** 当需要开通以下企业拓展服务时， 系统将返回一个操作链接。贵方需要主动联系并通知企业的超级管理员（超管）或法人。由他们点击该链接，完成服务的开通操作。
+        #   - **AUTO_SIGN（企业自动签）**
+        #   - **DOWNLOAD_FLOW（授权渠道下载合同）**
+        #   - **OVERSEA_SIGN（企业与港澳台居民签署合同）**
 
-        # 3. 客户小程序直接跳到电子签小程序-->腾讯电子签小程序操作完成--->回到客户小程序
-        # 跳转到小程序的实现，参考官方文档（分为<a href="https://developers.weixin.qq.com/miniprogram/dev/api/navigate/wx.navigateToMiniProgram.html">全屏</a>、<a href="https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/openEmbeddedMiniProgram.html">半屏</a>两种方式），如何配置也可以请参考: <a href="https://qian.tencent.com/developers/company/openwxminiprogram">跳转电子签小程序配置</a>
-        # 设置EndPoint为APP，得到path。
+        # 注意： `在调用此接口以管理企业扩展服务时，操作者（ Agent.ProxyOperator.OpenId）必须是企业的超级管理员（超管）或法人`
 
-        # 4.其中小程序的原始Id如下，或者查看小程序信息自助获取。
 
-        # | 小程序 | AppID | 原始ID |
-        # | ------------ | ------------ | ------------ |
-        # | 腾讯电子签（正式版） | wxa023b292fd19d41d | gh_da88f6188665 |
-        # | 腾讯电子签Demo | wx371151823f6f3edf | gh_39a5d3de69fa |
+        # 对应的扩展服务能力可以在控制台的【扩展服务】中找到
+        # ![image](https://qcloudimg.tencent-cloud.cn/raw/99eebd37883ec55ed1f1df3a57aee60a.png)
 
         # @param request: Request instance for ModifyExtendedService.
         # @type request: :class:`Tencentcloud::essbasic::V20210526::ModifyExtendedServiceRequest`

data/lib/v20210526/models.rb

@@ -2247,8 +2247,10 @@ module TencentCloud
         # @type ApproverRestrictions: :class:`Tencentcloud::Essbasic.v20210526.models.ApproverRestriction`
         # @param Operator: 暂未开放
         # @type Operator: :class:`Tencentcloud::Essbasic.v20210526.models.UserInfo`
+        # @param ForbidPersonalMultipleSign: 禁止个人用户重复签署，默认不禁止，即同一用户可多次扫码签署多份合同。若要求同一用户仅能扫码签署一份合同，请传入true。
+        # @type ForbidPersonalMultipleSign: Boolean
 
-        attr_accessor :Agent, :TemplateId, :FlowName, :MaxFlowNum, :FlowEffectiveDay, :QrEffectiveDay, :Restrictions, :ApproverComponentLimitTypes, :CallbackUrl, :ApproverRestrictions, :Operator
+        attr_accessor :Agent, :TemplateId, :FlowName, :MaxFlowNum, :FlowEffectiveDay, :QrEffectiveDay, :Restrictions, :ApproverComponentLimitTypes, :CallbackUrl, :ApproverRestrictions, :Operator, :ForbidPersonalMultipleSign
         extend Gem::Deprecate
         deprecate :CallbackUrl, :none, 2024, 10
         deprecate :CallbackUrl=, :none, 2024, 10
@@ -2257,7 +2259,7 @@ module TencentCloud
         deprecate :Operator, :none, 2024, 10
         deprecate :Operator=, :none, 2024, 10
 
-        def initialize(agent=nil, templateid=nil, flowname=nil, maxflownum=nil, floweffectiveday=nil, qreffectiveday=nil, restrictions=nil, approvercomponentlimittypes=nil, callbackurl=nil, approverrestrictions=nil, operator=nil)
+        def initialize(agent=nil, templateid=nil, flowname=nil, maxflownum=nil, floweffectiveday=nil, qreffectiveday=nil, restrictions=nil, approvercomponentlimittypes=nil, callbackurl=nil, approverrestrictions=nil, operator=nil, forbidpersonalmultiplesign=nil)
           @Agent = agent
           @TemplateId = templateid
           @FlowName = flowname
@@ -2269,6 +2271,7 @@ module TencentCloud
           @CallbackUrl = callbackurl
           @ApproverRestrictions = approverrestrictions
           @Operator = operator
+          @ForbidPersonalMultipleSign = forbidpersonalmultiplesign
         end
 
         def deserialize(params)
@@ -2306,6 +2309,7 @@ module TencentCloud
             @Operator = UserInfo.new
             @Operator.deserialize(params['Operator'])
           end
+          @ForbidPersonalMultipleSign = params['ForbidPersonalMultipleSign']
         end
       end
 
@@ -3436,6 +3440,67 @@ module TencentCloud
         end
       end
 
+      # ChannelDescribeAccountBillDetail请求参数结构体
+      class ChannelDescribeAccountBillDetailRequest < TencentCloud::Common::AbstractModel
+        # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
+
+        # 此接口下面信息必填。
+        # <ul>
+        # <li>渠道应用标识:  Agent.AppId</li>
+        # </ul>
+        # 第三方平台子客企业必须已经经过实名认证
+        # @type Agent: :class:`Tencentcloud::Essbasic.v20210526.models.Agent`
+
+        attr_accessor :Agent
+
+        def initialize(agent=nil)
+          @Agent = agent
+        end
+
+        def deserialize(params)
+          unless params['Agent'].nil?
+            @Agent = Agent.new
+            @Agent.deserialize(params['Agent'])
+          end
+        end
+      end
+
+      # ChannelDescribeAccountBillDetail返回参数结构体
+      class ChannelDescribeAccountBillDetailResponse < TencentCloud::Common::AbstractModel
+        # @param BoundAccountsNumber: 当前绑定中账号数量
+        # @type BoundAccountsNumber: Integer
+        # @param RemainAvailableAccountsNumber: 剩余可绑定账号数量
+        # @type RemainAvailableAccountsNumber: Integer
+        # @param InvalidAccountsNumber: 已失效账号数量
+        # @type InvalidAccountsNumber: Integer
+        # @param TotalBuyAccountsNumber: 购买数量
+        # @type TotalBuyAccountsNumber: Integer
+        # @param TotalGiftAccountsNumber: 赠送数量
+        # @type TotalGiftAccountsNumber: Integer
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :BoundAccountsNumber, :RemainAvailableAccountsNumber, :InvalidAccountsNumber, :TotalBuyAccountsNumber, :TotalGiftAccountsNumber, :RequestId
+
+        def initialize(boundaccountsnumber=nil, remainavailableaccountsnumber=nil, invalidaccountsnumber=nil, totalbuyaccountsnumber=nil, totalgiftaccountsnumber=nil, requestid=nil)
+          @BoundAccountsNumber = boundaccountsnumber
+          @RemainAvailableAccountsNumber = remainavailableaccountsnumber
+          @InvalidAccountsNumber = invalidaccountsnumber
+          @TotalBuyAccountsNumber = totalbuyaccountsnumber
+          @TotalGiftAccountsNumber = totalgiftaccountsnumber
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @BoundAccountsNumber = params['BoundAccountsNumber']
+          @RemainAvailableAccountsNumber = params['RemainAvailableAccountsNumber']
+          @InvalidAccountsNumber = params['InvalidAccountsNumber']
+          @TotalBuyAccountsNumber = params['TotalBuyAccountsNumber']
+          @TotalGiftAccountsNumber = params['TotalGiftAccountsNumber']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ChannelDescribeBillUsageDetail请求参数结构体
       class ChannelDescribeBillUsageDetailRequest < TencentCloud::Common::AbstractModel
         # @param Agent: 关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。
@@ -9181,11 +9246,12 @@ module TencentCloud
 
       # ModifyExtendedService返回参数结构体
       class ModifyExtendedServiceResponse < TencentCloud::Common::AbstractModel
-        # @param OperateUrl: 操作跳转链接，有效期24小时
-        # 若操作时没有返回跳转链接，表示无需跳转操作，此时会直接开通/关闭服务。
+        # @param OperateUrl: 操作跳转链接
+        # <ul><li><strong>链接有效期：</strong> 跳转链接的有效期为24小时。</li>
+        # <li><strong>没有返回链接的情形：</strong> 如果在操作时没有返回跳转链接，说明此次操作无需进行跳转，服务将会直接被开通或关闭。</li>
+        # <li><strong>返回链接的情形：</strong> 当操作类型为“OPEN”（开通服务），并且扩展服务类型为“AUTO_SIGN”（自动签名）、“DOWNLOAD_FLOW”（下载流程）或“OVERSEA_SIGN”（海外签名）时，系统将返回一个操作链接。收到操作链接后，贵方需主动联系超级管理员（超管）或法人。由超管或法人点击链接，以完成服务的开通操作。</li>
+        # </ul>
 
-        # 当操作类型是 OPEN 且 扩展服务类型是 AUTO_SIGN 或 DOWNLOAD_FLOW 或者 OVERSEA_SIGN 时返回操作链接，
-        # 返回的链接需要平台方自行触达超管或法人，超管或法人点击链接完成服务开通操作
         # @type OperateUrl: String
         # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-essbasic
 version: !ruby/object:Gem::Version
-  version: 3.0.922
+  version: 3.0.923
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-12 00:00:00.000000000 Z
+date: 2024-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common