Zoho crm Logo

更改所有者

目的

在Zoho CRM中更改单个记录或多个记录的所有者。

端点

  • POST /{module_API_name}/actions/change_owner
  • POST /{module_API_name}/{record_ID}/actions/change_owner

Request 详细信息

Request URL

对于多条记录: 
{api-domain}/crm/{version}/{module_API_name}/actions/change_owner

对于单条记录: 
{api-domain}/crm/{version}/{module_API_name}/{record_ID}/actions/change_owner

支持的模块

潜在客户,账户,联系人,交易,活动,任务,案例,事件,呼叫,解决方案,产品,供应商,价格书,报价,销售订单,采购订单,发票,和自定义

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

ZohoCRM.change_owner.CREATE

样本请求

输入 JSON

  • idsJSON 数组,当您想要更改多个记录的所有者时,此为必填项

    指定您想要更改所有权的记录的ID。在单个API调用中,您可以包含多达 500个记录ID。

  • 所有者JSON 对象,必填

    提供新所有者的ID,记录将被分配给他。

  • related_modulesJSON 对象,可选

    与记录相关的会议、任务或呼叫的API名称和记录ID。如果指定,这些相关记录也将被转移到新的所有者。请注意,如果您已经指定了API名称和相关模块的ID,而只有其中一个是有效的,系统将继续使用有效的那一个。除非指定,否则这些相关记录的所有权将不会被转移。

  • notify布尔值,可选

    表示当你分配记录时,是否希望通过电子邮件通知新的所有者。
    可能的值:
    false - 新的所有者将不会通过电子邮件被通知。这是默认值。
    true - 新的所有者将会通过电子邮件被通知。

样本输入

可能的错误

  • INVALID_REQUEST_METHODHTTP 400

    请求方法不正确。
    解决方案:使用HTTP POST方法来进行此API调用。任何其他请求方法都会导致此错误。

  • MANDATORY_NOT_FOUNDHTTP 400

    您没有在请求体中指定ID,或者"ids"数组为空,或者您没有指定所有者的详细信息。
    解决方案:当您想要更改多个记录的所有者时,"ids"数组是必需的。此API需要所有者的ID。响应中的"api_name"和"json_path"键提供了输入中缺少的内容的详细信息。

  • INVALID_DATAHTTP 400

    所有者的ID或"ids"数组中的一个或多个记录的ID无效。
    解决方案:在输入中指定有效值。

  • NOT_SUPPORTEDHTTP 400

    您在 "related_modules" 数组中指定了无效的模块 API 名称,或者给定的模块在此 API 中不受支持。
    解决方案:确保您在 URL 中为模块指定正确的 API 名称,或在请求体中指定相关模块。请参阅支持的模块部分,查看与此 API 兼容的模块列表。只允许将所有权转移给与指定记录相关的任务、会议和呼叫的相关记录。

  • EXPECTED_FIELD_MISSINGHTTP 400

    您未指定API名称或相关模块的ID。
    解决方案:请参考响应中的"expected_fields"数组,以获取缺失字段的API名称和JSON路径。

  • AMBIGUITY_DURING_PROCESSINGHTTP 400

    您在输入中指定了一个或多个错误的值。
    解决方案:请参考响应中的"ambiguity_due_to"数组,以获取API名称和JSON路径的无效数据。

  • RECORD_LOCKEDHTTP 400

    您无法执行此操作,因为记录已被锁定。
    解决方案:请等待记录解锁。

  • AUTHENTICATION_FAILUREHTTP 401

    您未使用有效的访问令牌授权API调用。
    解决方案:在请求头中包含有效的访问令牌以授权API调用。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    您用来进行此API调用的访问令牌没有所需的范围。
    解决方案:生成具有此API所需范围的新访问令牌。请参阅此页面开头的范围部分,以获取所需范围的列表。

  • INVALID_URL_PATTERNHTTP 404

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

  • INTERNAL_ERRORHTTP 500

    服务器中出现意外且未处理的异常。 
    解决方案:联系support@zohocrm.com的支持团队。

样本回应