Método updateRelatedRecords – Comparação
Finalidade
Para atualizar os registros relacionados a outro registro.
URL de solicitação
Versão 1.0:
https://crm.zoho.com/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
Versão 2.0:
URL: https://www.zohoapis.com/crm/v2/{module_api_name}/{record_id}/{relatedlist_api_name}/{related_record_id}
Método: GET
Corpo de solicitação: o conteúdo de um registro fornecido no formato JSON.
Header: Authorization=Zoho-oauthtoken {oauth_token}
Por exemplo: https://www.zohoapis.com/crm/v2/Campaigns/1386586000000803001/Contacts/138658600000059902
Observação:
- Os nomes API das listas relacionadas podem ser encontrados usando essa API(GET) – https://www.zohoapis.com/crm/v2/settings/related_lists?module=Campaigns
Parâmetros de solicitação
| Versão 1.0 | Versão 2.0 |
|---|---|
| authtoken=**** | Authorization=Zoho-oauthtoken ***** – como Header. |
| scope=crmapi | N/A |
| relatedModule | Fornecido na URL de solicitação. |
| id | Fornecido na URL de solicitação. |
| XmlData Ex. xmlData=<Contacts><row no="1"><FLval="CONTACTID">1386586000000599023</FL><FLval="member_status">Sent</FL></row></Contacts>&id=1386586000000803001 | N/A Os dados necessários devem ser fornecidos no corpo da solicitação. { "data": [ { "Member_Status":"Sent" } ] } |
Respostas de amostra:
| Resposta na Versão 1.0 | Resposta na Versão 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": "relação adicionada", "status": "success" } ] } |