从用户中移除领地
目的
从用户中移除特定的领土。
端点
- DELETE /Users/{user_id}/territories/{territory_id}
- DELETE /Users/{user_id}/territories?ids={territory_1},{territory_2},{territory_3},...
请求详情
请求URL
从用户中移除一个区域
{api-domain}/crm/{version}/Users/{user_id}/territories/{territory_id}
从用户中移除多个区域
{api-domain}/crm/{version}/Users/{user_id}/territories?ids={territory_1},{territory_2},{territory_3},...
标题
授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope = ZohoCRM.users.{operation_type} 和
scope = ZohoCRM.settings.territories.{operation_type}
可能的操作类型
全部 - 完全访问领土
Delete - Delete 用户的领土
参数
- ids字符串,可选(对于从用户中批量移除区域,该参数是必需的)
表示区域的唯一ID。在一次API调用中最多可以指定100个区域。
注意事项
- 一个区域不能从其指定的经理(区域的所有者)中移除。
- 默认区域不能被移除。
以下是一个请求示例,用于从用户中移除单个区域:
Copied"https://www.zohoapis.com/crm/v8/Users/5725767000000583004/territories/5725767000002709047"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"可能的错误
- INVALID_DATAHTTP 400
- 给定的用户ID似乎无效
解决方案:请指定一个有效的用户ID。请参考GET Users API以检索可用的Users及其唯一ID。 - 一个或多个给定的领地ID似乎无效
解决方案:指定有效的领地ID。 - 给定的用户ID已被删除或未关联到Zoho CRM
解决方案:请指定一个与Zoho CRM关联的有效用户ID。 - 无法从用户中移除组织领地
解决方案:默认领地无法移除。请指定有效的领地。 - 领土ID未与指定用户关联
解决方案:指定与用户关联的领土。要了解特定用户的分配领土,请使用用户领土API。 - 无法从用户处移除该领地
解决方案:用户是该领地的管理者,您无法从用户处移除该领地。
- 给定的用户ID似乎无效
- NOT_ALLOWEDHTTP 400
您无法更新您所属的区域
解决方案:您只能移除您不属于的区域。 - INVALID_REQUEST_METHODHTTP 400
HTTP请求方法类型无效
解决方法:您指定了一个无效的HTTP方法来访问API URL。
请指定一个有效的请求方法。请参阅上面的端点部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未授权
解决方法:客户端没有有效的范围来从用户中移除区域。请创建一个具有有效范围的新令牌。请参阅上面的范围部分。 - Authentication_FAILUREHTTP 401
Authentication 失败
解决方法: 在API调用的请求头中传递访问令牌。 - INVALID_URL_PATTERNHTTP 404
请检查尝试访问的URL是否正确
解决方案: 请求的URL不正确。请指定一个有效的请求URL。请参阅上面的请求URL部分。 - INTERNAL_ERRORHTTP 500
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。
响应
Copied{
"territories": [
{
"code": "SUCCESS",
"details": {
"id": "5725767000002709047"
},
"message": "Territory removed from the user successfully",
"status": "success"
}
]
}示例请求以从用户中删除大量区域
Copied"https://www.zohoapis.com/crm/v8/Users/5725767000000583004/territories?ids=5725767000000452115,5725767000000454003,5725767000002709047"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
示例响应
Copied{
"territories": [
{
"code": "SUCCESS",
"details": {
"id": "5725767000000452115"
},
"message": "Territory removed from the user successfully",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "5725767000000454003"
},
"message": "Territory removed from the user successfully",
"status": "success"
},
{
"code": "INVALID_DATA",
"details": {},
"message": "This user cannot be removed as the user is a manager of the mentioned Territory.",
"status": "error"
},
{
"code": "INVALID_DATA",
"details": {},
"message": "This user cannot be removed as the user is a manager of the mentioned Territory.",
"status": "error"
},
{
"code": "SUCCESS",
"details": {
"id": "5725767000002709047"
},
"message": "Territory removed from the user successfully",
"status": "success"
}
]
}