updateRelatedRecords 方法
目的
您可以使用updateRelatedRecords方法更新另一条记录相关的记录。
支持的模块
模块 | 相关模块 |
宣传 | 线索 |
产品 | 线索 |
注意:
- 还可能在将任何相关模块保存为父模块的情况下更新宣传或产品。
请求 URL
更新宣传相关的联系人成员状态
XML 格式:
https://crm.zoho.com.cn/crm/private/xml/Campaigns/updateRelatedRecords?authtoken=Auth Token&scope=crmapi
&relatedModule=Contacts&xmlData=<Contacts><row no="1"><FL val="CONTACTID">9999999999</FL><FL val="member_status">Sent</FL></row></Contacts>&id=99999999999
JSON 格式:
https://crm.zoho.com.cn/crm/private/json/Campaigns/updateRelatedRecords?authtoken=Auth Token&scope=crmapi&relatedModule=Contacts&xmlData=<Contacts><row no="1"><FL val="CONTACTID">9999999999</FL><FL val="member_status">Sent</FL></row></Contacts>&id=99999999999
请求参数
参数 | 数据类型 | 说明 |
authtoken* | 字符串 | 验证您的 Zoho 凭据的加密字母数字字符串。 |
scope* | 字符串 | 将数值指定为 crmapi。 |
relatedModule* | 字符串 | 记录相关的模块。
例如: 如果宣传相关的线索需要更新,此参数的值将为线索。 |
id* | 整数值 | 须更新的记录 ID。 |
xmlData* | XML | 须通过的 XML 值。 |
* - 必填参数
注意:
- 参考发布说明页面了解关于 API 执行中进行的增强的更多信息。
其它说明
- 您可以更新最多100 条记录。
- 从您的 Zoho CRM 账户中检索数据时,基于角色的安全(角色、概要文件、字段级别的安全和数据共享规则)应用。 关于基于角色的安全设置,请参阅安全管理。
示例
如需更新价格册相关的产品列表价格
https://crm.zoho.com.cn/crm/private/xml/PriceBooks/updateRelatedRecords?authtoken=Your Authenticaton Token&scope=crmapi&id=Price Book ID&relatedModule=Products&xmlData=<Products><row no="1"><FL val="PRODUCTID">508020000000061987</FL><FL val="list_price">100.00</FL></row></Products>
响应格式
<response uri="/crm/private/xml/PriceBooks/updateRelatedRecords">
<result>
<status>
<code>200</code>
</status>
<success>
<code>4800</code>
</success>
<updated-ids>[508020000000061987]</updated-ids>
</result>
</response>