Zoho crm Logo

获取记录的领土

目的

要获取分配给您Zoho CRM 组织中记录的领土详细信息。

端点

  • GET /{module_api_name}/{record_id}

请求详情

请求URL

{api-domain}/crm/{version}/{module_api_name}/{record_id}

支持的模块

潜在客户,Account,联系人和交易

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.modules.ALL
(或)
ZohoCRM.modules.{module_name}.{operation_type}

可能的模块名称

线索、账户、联系人和交易

可能的操作类型

全部 - 完全访问记录
读取 - 读取模块中的记录

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Deals/554023000000497035"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X GET

响应 JSON

  • Name string

    表示领土的Name。

  • id string

    表示领土的唯一ID。

  • $assigned_byJSON object

    表示将区域分配给记录的用户的姓名和ID。

  • $assigned_time string

    表示将区域分配给记录的日期和时间。

  • $assigned string

    表示记录的领土是如何分配的。
    可能的值:
    manually: 用户通过API或UI手动分配领土。
    automatically: 系统自动分配领土。

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    HTTP请求方法类型无效
    解决方法:您指定了一个无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参阅上面的端点部分。

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限访问记录
    解决方案:用户没有访问记录的权限。请联系您的系统管理员。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用于进行此 API 调用的访问令牌不具有所需的范围。
    解决方法:生成一个具有此 API 所需范围的新访问令牌。请参阅本页开头的范围部分以获取所需范围的列表。

  • NO_PERMISSIONHTTP 403

    无权限读取记录
    解决方案:用户没有读取记录的权限。请联系系统管理员。

  • INTERNAL_ERRORHTTP 500

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

示例响应

Copied{
  "data": [
    {
      "Owner": {
        "name": "Patricia Boyle",
        "id": "111111000000043376",
        "email": "p.boyle@abc.com"
      },
      "Territories": [
        {
          "Name": "Texas",
          "id": "111111000000046898",
          "$assigned_by": null,
          "$assigned_time": "2020-03-05T16:07:28+05:30",
          "$assigned": "automatically"
        },
        {
          "Name": "South",
          "id": "111111000000046458",
          "$assigned_by": {
            "name": "Patricia Boyle",
            "id": "111111000000043376"
          },
          "$assigned_time": "2020-03-05T16:07:28+05:30",
          "$assigned": "manually"
        }
      ]
    }
  ]
}