Zoho crm Logo

添加或更新用户的领域

目的

添加或更新与用户相关的领域。

端点

  • PUT /users/{user_id}/territories

Request 详情

Request URL

{api-domain}/crm/{version}/users/{id}/territories

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.users.{operation_type}
(或)
scope=ZohoCRM.settings.territories.{operation_type}

可能的操作类型

ALL - 对记录的完全访问
UPDATE - 在模块中更新记录

样本请求

输入 JSON 键

  • id字符串,必填

    代表您想要分配给用户的领土的唯一ID。您可以在"territories"数组下有多达100个JSON对象。

样本输入

可能的错误

  • INVALID_DATAHTTP 400

    您在输入中指定了无效的领土ID。
    解决方案:使用获取领土API来获取领土的唯一ID。

  • LIMIT_EXCEEDEDHTTP 400

    您尝试在一个API调用中添加或更新超过100个领域。
    解决方案:您只能在一个API调用中向用户添加或更新最多100个领域。

  • DUPLICATE_DATAHTTP 400

    用户已与领土关联。
    解决方案:请参考响应中"details"键的"json_path"键,找出已与用户关联的领土的ID。从输入中删除它以避免此错误。

  • MANDATORY_NOT_FOUNDHTTP 400

    未找到必填字段。
    解决方案:您必须在输入中指定领土ID。

  • expected_data_typeHTTP 400

    输入中的ID数据类型与预期的不匹配。
    解决方案:您必须将领土ID指定为字符串,且只能包含数字(长数字)。

  • NOT_ALLOWEDHTTP 400

    已登录用户不能更新他们自己的领土。

样本回应