Zoho crm Logo

合并标签

目的

将两个不同的标签合并成一个。

端点

  • POST /settings/tags/{tag_ID}/actions/merge

请求详情

请求 URL

{api-domain}/crm/{version}/settings/tags/{tag_ID}/actions/merge

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.ALL
(或)
ZohoCRM.settings.tags.{operation_type}

可能的操作类型

全部 - 完整数据访问
写入 - Edit 标签数据
创建 - 创建标签数据

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/settings/tags/2000000035058/actions/merge"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@mergetag.json"
Copiedtag1 = Map();
tag1.put("conflict_id", "692969000000995002");

tags_list = List();
tags_list.add(tag1);

param = Map();
param.put("tags", tags_list);

res = invokeurl
[
	url :"https://www.zohoapis.com/crm/v8/settings/tags/692969000000995001/actions/merge"
	type :POST
	parameters: param.toString()
	connection:"crm_oauth_connection"
];
info res;

在输入中,@mergetag.json 包含示例输入数据。

输入 JSON

  • conflict_id string, mandatory

    指定要合并的标签的唯一ID。使用获取标签列表API来检索标签ID。

注意

当一个标签被合并时,相关的记录将会更新为新标签。例如,如果标签A被合并到标签B,所有之前链接到标签A的记录现在将显示为标签B。

示例输入

Copied{
    "tags": [
       {
            "conflict_id": "<电话号码_1>"
        }
    ]
}

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    HTTP请求方法类型无效
    解决方案:您指定了一个无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参阅端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限合并标签
    解决方案:用户没有合并标签的权限。请联系系统管理员。

  • INVALID_DATAHTTP 400

    数据无效
    解决方法:指定的输入不正确。请指定有效的输入

  • MANDATORY_NOT_FOUNDHTTP 400

    必填字段未找到
    解决方法: 您在输入中未指定一个或多个必填字段。请参阅字段元数据 API了解必填字段。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:客户端没有ZohoCRM.settings.tags.CREATE范围。创建一个具有有效范围的新客户端。请参阅范围部分。

  • NO_PERMISSIONHTTP 403

    没有权限合并标签
    解决方案:用户没有合并标签的权限。请联系系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方案: 请求的URL不正确。请指定一个有效的请求URL。请参阅请求URL部分。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方法:服务器中出现意外且未处理的异常。请联系支持团队。

示例响应

Copied{
    "tags": [
       {
            "code": "SUCCESS",
            "message": "标签合并成功",
            "status": "success",
            "details": {
                "created_by": {
                    "id": "2000000030874",
                    "name": "医疗"
                },
                "created_time": "2024-03-24T11:08:23+05:30",
                "id": "2000000088041",
                "modified_by": {
                    "id": "2000000030444",
                    "name": "化学"
                },
                "modified_time": "2024-03-24T11:08:23+05:30"
            }
        }
    ]
}