更新相关记录
目的
更新记录之间的关系。
端点
- PUT /{module_api_name}/{record_id}/{related_list_api_name}/{related_record_id}
请求详情
请求 URL
{api-domain}/crm/{version}/{module_api_name}/{record_id}/{related_list_api_name}/{related_record_id}
支持的关系
活动 - 到 - 线索、联系人
产品 - 到 - 线索、Account,
联系人、商机、价格手册
预约 - 到 - 服务
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.modules.ALL
(或)
scope=ZohoCRM.modules.{module_name}.{operation_type}
可能的模块名称
线索、交易、联系人、账户、产品、活动、预约、服务和价格表
可能的操作类型
全部 - 完全访问记录
写入 - Edit 相关记录
Update - Update 相关记录
示例请求:添加潜在客户与活动之间的关联
Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/34876876000000376008/Campaigns"
-X PUT
-d @updaterelatedlead.json
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"CopiedSyntax:
zoho.crm.updateRelatedRecord(<module String>,<recordID Long>,<parentModuleName String>,<parentRecordId Long>,<dataMap Map>,<connectionName String>,<userAccess Boolean>);
mandatory : module,recordID,parentModuleName,parentRecordId,dataMap
Sample Request:
resp = zoho.crm.updateRelatedRecord("Related_List_Name_2","7000000037119","Leads","7000000037002", Map());请求JSON键
- id字符串,必填
请指定要关联的相关记录的唯一ID。可参考获取记录API来获取记录的唯一ID。
注意
- 在为其他模块添加关联时,必须发送样本数据。
- 若要将某个模块的多个记录关联到父模块,您必须为每个相关记录分别传递一个 JSON 对象,如示例所示。
- 每次 API 调用最多可更新 100 条关联记录。
示例输入
Copied{
"data":[
{
"id":"3652397000000327001",
"Member_Status":"Active"
},
{
"id":"3652397000001854001",
"Member_Status":"Planning"
}]
}可能的错误
- INVALID_MODULEHTTP 400
给定的模块名称似乎无效
解决方法: 您指定了无效的模块名称,或者没有选项卡权限,或者该模块已被从可用模块中移除。请指定一个有效的模块 API 名称。 - INVALID_MODULEHTTP 400
所提供的模块在API中不受支持
解决方法:当前API不支持如“文档”和“项目”等模块。(一旦这些模块被支持,此错误将不会再显示。)请指定一个有效的模块API名称。 - INVALID_URL_PATTERN HTTP 404
请检查尝试访问的URL是否正确
解决方法:指定的请求URL不正确,请指定一个有效的请求URL。请参考上述请求URL部分。 - OAUTH_SCOPE_MISMATCHHTTP 401
未授权
解决方法:客户端没有 ZohoCRM.modules.{module_name}.UPDATE 的权限范围。请创建一个具有有效权限范围的新客户端。请参考上方的权限范围部分。 - NO_PERMISSIONHTTP 403
无权更新记录
解决方法:用户没有权限更新相关记录数据。请联系您的系统管理员。 - INTERNAL_ERRORHTTP 500
服务器内部错误
解决方法: 服务器中发生了意外且未处理的异常。请联系支持团队。 - INVALID_REQUEST_METHODHTTP 400
HTTP 请求方法类型无效
解决方法:您为访问 API URL 指定了无效的 HTTP 方法。请指定有效的请求方法。请参阅上方的端点部分。 - AUTHORIZATION_FAILEDHTTP 400
用户没有足够的权限来更新相关记录数据
解决方法:该用户没有权限更新相关记录数据。请联系系统管理员。 - INVALID_DATAHTTP 400
所提供的关联ID似乎无效
解决方案:您指定了错误的关联记录ID。请指定一个有效的记录ID。请参考获取关联记录API以获取有效的记录ID。 - INVALID_DATAHTTP 400
无效数据
解决方法:指定的输入不正确。请指定有效的输入 - MANDATORY_NOT_FOUNDHTTP 400
未找到必填字段
解决方法:您在输入中未指定一个或多个必填字段。请参考字段元数据 API了解必填字段。
示例回应
Copied{
"data": [
{
"code": "SUCCESS",
"details": {
"id": "3652397000000327001"
},
"message": "relation added",
"status": "success"
},
{
"code": "SUCCESS",
"details": {
"id": "3652397000001854001"
},
"message": "relation added",
"status": "success"
}
]
}