1. 接口描述

接口请求域名： essbasic.tencentcloudapi.com 。

此接口（OperateChannelTemplate）用于针对第三方应用平台模板库中的模板对子客企业发布授权的查询和设置。
平台模板库中的模板的位置在控制台 企业应用管理 中下面的应用模板库管理目录, 可以参照下图位置

支持的操作

1. 查询模板的子客企业授权 (OperateType=SELECT)

• 查询模板的授权子企业列表

2. 修改模板的子客企业授权 (OperateType=UPDATE)

• 当模板未发布时，可以修改模板的模板授权范围是所有第三方应用合作企业(AuthTag设置为all)或者指定第三方应用合作企业(AuthTag设置为part)，当模板发布后，不可做此修改
• 如果模板是部分授权, 可通过ProxyOrganizationOpenIds增加子客的授权范围。

3. 取消模板的子客企业授权 (OperateType=DELETE)

• 对子客企业进行模板库中模板授权范围的进行删除操作。
• 主要对于手动领取的模板，去除授权后子客在模板库中看不到，就无法再领取了。但是已经领取过成为自有模板的不会同步删除。
• 对于自动领取的模板，由于已经下发，更改授权不会影响。
• 如果要同步删除子客自有模板库中的模板，请使用OperateType=UPDATE+Available参数处理。

默认接口请求频率限制：200次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：OperateChannelTemplate。
Version	是	String	公共参数，本接口取值：2021-05-26。
Region	否	String	公共参数，此参数为可选参数。
Agent	是	Agent	关于渠道应用的相关信息，包括渠道应用标识、第三方平台子客企业标识及第三方平台子客企业中的员工标识等内容，您可以参阅开发者中心所提供的 Agent 结构体以获取详细定义。 此接口下面信息必填。 渠道应用标识: Agent.AppId
OperateType	是	String	操作类型，可取值如下: SELECT: 查询 DELETE: 删除 UPDATE: 更新 示例值：SELECT
TemplateId	是	String	合同模板ID，为32位字符串。 注: 此处为第三方应用平台模板库模板ID，非子客模板ID 示例值：yDSLZUUckpot5i01UydF1AEvOMQiKaBG
ProxyOrganizationOpenIds	否	String	第三方平台子客企业的唯一标识，支持批量(用,分割) 一次批量操作最多支持100个第三方平台子客 示例值：org_dianziqian,org_zhangsan
AuthTag	否	String	模板可见范围, 可以设置的值如下: all: 所有本第三方应用合作企业可见 part: 指定的本第三方应用合作企业 对应控制台的位置 示例值：part
Available	否	Integer	当OperateType=UPDATE时，可以通过设置此字段对模板启停用状态进行操作。 0: 不修改模板可用状态 1: 启用模板 2: 停用模板 启用后模板可以正常领取。 停用后，推送方式为【自动推送】的模板则无法被子客使用，推送方式为【手动领取】的模板则无法出现被模板库被子客领用。 如果Available更新失败，会直接返回错误。 示例值：1
Limit	否	Integer	指定分页每页返回的数据条数，单页最大支持 100。 不传默认值为 20 示例值：20
Offset	否	Integer	分页查询偏移量，默认为0 示例值：0

3. 输出参数

4. 示例

示例1 查询授权子客openids

输入示例

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: OperateChannelTemplate
<公共请求参数>

{
    "Agent": {
        "AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOjw2"
    },
    "OperateType": "select",
    "TemplateId": "yDSLOUUckpoqdttsUxPuHh1wkuixnkwj",
    "Limit": 1,
    "Offset": 46
}

输出示例

{
    "Response": {
        "AppId": "yDwFoUUckpsomwx1UyhWGhIR2RkhOjw2",
        "AuthTag": "all",
        "FailMessageList": [],
        "OperateResult": "all-success",
        "ProxyOrganizationOpenIds": [
            "Z912024120909230059"
        ],
        "TemplateId": "yDSLOUUckpoqdttsUxPuHh1wkuixnkwj",
        "Total": 210,
        "RequestId": "32ed5c17-83f1-4064-aa11-6d454c40d7a7"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。