一个领土的子领土
目的
在您的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
- 键 reporting_to.id, manager.id, id, permission_type, created_by, modified_by
- 页面整数,可选
获取相应页面的记录列表。页面的默认值为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
内部服务器错误
解决方案:服务器中出现意外且未处理的异常。请联系支持团队。