合并标签
目的
将两个不同的标签合并成一个。
端点
- 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"
}
}
]
}