Zoho crm Logo

从用户中移除领地

目的

从用户中移除特定的领土。

端点

  • 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。
    • 无法从用户处移除该领地
      解决方案:用户是该领地的管理者,您无法从用户处移除该领地。
  • 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"
        }
    ]
}