更改所有者
目的
在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的支持团队。