updateRelatedRecords 方法 - 对比
用途
更新与另一个记录相关的记录。
请求URL
版本 1.0:
https://crm.zoho.com.cn/crm/private/xml/Campaigns/updateRelatedRecords?authtoken=AuthToken&scope=crmapi&relatedModule=Contacts&xmlData=<Contacts><row no="1"><FLval="CONTACTID">9999999999</FL><FLval="member_status">Sent</FL></row></Contacts>&id=99999999999
版本 2.0:
URL: https://www.zohoapis.com.cn/crm/v2/{module_api_name}/{record_id}/{relatedlist_api_name}/{related_record_id}
Method: GET
Request body: 以JSON格式给出的记录内容。
Header: Authorization=Zoho-oauthtoken {oauth_token}
例如: https://www.zohoapis.com.cn/crm/v2/Campaigns/1386586000000803001/Contacts/138658600000059902
备注:
- 可以使用这个API(GET)找到相关列表的API名称 - https://www.zohoapis.com.cn/crm/v2/settings/related_lists?module=Campaigns
请求参数
版本 1.0 | 版本 2.0 |
---|---|
authtoken=**** | Authorization=Zoho-oauthtoken ***** - 作为一个 Header。 |
scope=crmapi | N/A |
relatedModule | 在请求URL中给出。 |
id | 在请求URL中给出。 |
XmlData Ex. xmlData=<Contacts><row no="1"><FLval="CONTACTID">1386586000000599023</FL><FLval="member_status">Sent</FL></row></Contacts>&id=1386586000000803001 | N/A 要求的数据必须在请求正文中给出。 { "data": [ { "Member_Status":"Sent" } ] } |
示例响应:
版本 1.0 响应 | 版本 2.0 响应 |
---|---|
<?xml version="1.0" encoding="UTF-8" ?> <response uri="/crm/private/xml/Campaigns/updateRelatedRecords"> <result> <status> <code>200</code> </status> <success> <code>4800</code> </success> <addedids>[1386586000001867241]</added-ids> </result> </response> | { "data": [ { "code": "SUCCESS", "details": { "id": "1386586000002576001" }, "message": "relation added", "status": "success" } ] } |