updateRelatedRecords methode
Doel
U kunt de updateRelatedRecords methode gebruiken voor het bijwerken van records gerelateerd aan een ander record.
Ondersteunde modules
| Module | Gerelateerde module |
| Campaigns | Leads |
| Products | Leads |
Opmerking:
- Het is ook mogelijk om een campagne of product bij te werken met behoud van een van de gerelateerde modules als de parent module.
URL van het verzoek
Voor het bijwerken van de lidstatus van een contactpersoon gerelateerd aan een campagne
XML-indeling:
https://crm.zoho.com/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-indeling:
https://crm.zoho.com/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
Parameters van het verzoek
| Parameter | Gegevenstype | Beschrijving |
| authtoken* | String | Versleutelde alfanumerieke tekenreeks ter verificatie van uw Zoho inloggegevens. |
| scope* | String | Voer als waarde crmapi in. |
| relatedModule* | String | De module waaraan een record is gerelateerd. Bijvoorbeeld: als een lead die gerelateerd is aan een campagne moet worden bijgewerkt, wordt de waarde voor deze parameter Leads. |
| id* | Integer | De ID van de record die moet worden bijgewerkt. |
| xmlData* | XML | De door te geven XML-waarden. |
* - Verplichte parameter
Opmerking:
- Raadpleeg de Releaseopmerkingen voor meer informatie over doorgevoerde verbeteringen in de API-implementatie.
Aanvullende opmerkingen
- U kunt maximaal 100 records bijwerken.
- Tijdens het ophalen van gegevens uit uw Zoho CRM-account wordt beveiliging op basis van rollen (rollen, profielen, beveiliging op veldniveau en regels voor het delen van gegevens) toegepast. Voor beveiliging op basis van rollen, zie Beveiligingsbeheer.
Voorbeelden
Het bijwerken van de catalogusprijs van een product gerelateerd aan een prijslijst
https://crm.zoho.com/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>
Indeling response
<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>