Zoho crm Logo

一个领土的子领土

目的

在您的Zoho CRM组织中检索您领土的子领土的详细信息。

端点

  • GET /settings/territories/{territory_ID}/__child_territories

Request 详情

Request URL

{api-domain}/crm/{version}/settings/territories/{territory_ID}/__child_territories

标题

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.settings.territories.{operation_type}

Possible operation types

ALL - 对领土数据的全面访问
READ - 读取领土数据

参数

  • 过滤器 
    过滤器参数可以用来检索您正在搜索的子领域的详细信息。
    例如,filters={"field": {"api_name" : "manager.id"},"value":"431581000000278001" ,"comparator": "equal"}
    这可以用来查找其经理是J Smith(其用户id是431581000000278001)的领域。
    键和比较器

    • 键 reporting_to.id, manager.id, id, permission_type, created_by, modified_by
      比较器 equal, not_equal
    • 键 name
      比较器 equal, not_equal, ends_with, starts_with, contains, not_contains
    • 键 created_time, modified_time
      比较器 less_equal, between, greater_than, less_than, equal
  • 页面整数,可选

    获取相应页面的记录列表。页面的默认值为1。
    可能的值:仅正整数。

  • per_page整数,可选

    获取每页可用记录的列表。默认值和可能的最大值是200。
    可能的值:仅正整数值。

样本请求

Response JSON 键

  • created_time string

    表示创建当前领土的日期和时间。

  • 经理JSON 对象

    代表当前领地经理的名称和ID。

  • account_rule_criteria JSON 对象

    代表账户模块领域规则的标准(比较器,字段和值)

  • description string

    表示领土的描述(如果有的话)。

  • lead_rule_criteria JSON 对象

    代表潜在客户模块领域规则的标准(比较器,字段和值)

  • reporting_to string

    代表父级领土的唯一ID。

  • deal_rule_criteria JSON 对象

    代表交易模块领域规则的标准(比较器,字段和值)

  • permission_type string

    代表了领土的权限类型。可能的值有 read_only 和 read_write_delete。

  • modified_time string

    表示当前领域最后一次修改的日期和时间。

  • name string

    代表领土的名称。

  • modified_byJSON object

    表示最后修改当前领土的用户的姓名和ID。

  • id string

    代表领土的唯一ID。

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限来读取领土
    解决方案:用户没有权限获取领土数据。请联系您的系统管理员。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:客户端没有ZohoCRM.settings.territories.READ范围。创建一个具有有效范围的新客户端。范围在此页面的开头

  • NO_PERMISSIONHTTP 403

    拒绝访问权限
    解决方案:用户没有权限读取领域数据。请联系您的系统管理员。

  • INVALID_URL_PATTERNHTTP 404

    请求的URL不正确。
    解决方案:指定一个有效的请求URL。请参考本页开头的URL部分以获取更多详细信息。

  • INTERNAL_ERRORHTTP 500

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

样本回应