updateRecordsメソッド - 比較

目的

特定または複数のデータを更新します。

リクエストURL

バージョン1.0:

https://crm.zoho.com/crm/private/xml/Leads/updateRecords?authtoken=AuthToken&scope=crmapi&id=Record ID&xmlData=XML Data

バージョン2.0:

URL: https://www.zohoapis.com/crm/v2/Leads/{record_id}

メソッド:PUT

リクエストボディ:JSON形式

ヘッダー:Authorization=Zoho-oauthtoken {oauth_token}

リクエストパラメーター

バージョン1.0バージョン2.0
authtoken=****Authorization=Zoho-oauthtoken ***** - ヘッダー
scope=crmapiN/A
xmlDataN/A - 入力データは、リクエストボディで指定する必要があります。
ididは、各JSONObjectで指定する必要があります。
wfTrigger=true"trigger":["workflow","approval","blueprint"]
上記のキーは、リクエストボディで指定する必要があります。
newFormatN/A
versionN/A
 

APIリクエスト例:

バージョン1.0のリクエストバージョン2.0のリクエスト
https://crm.zoho.com/crm/private/xml/Leads/insertRecords?authtoken=****&id=1386586000002577004&xmlData=<Leads><row no="1"><FL val="Last Name">test2</FL><FL val="Company">com2</FL></row></Leads>URL - https://www.zohoapis.com/crm/v2/Leads/1386586000002577004
Body:
  {
    "data": [
      {
        "Last_Name":"Jason",
        "Company":"Zylker Corp"
      }
    ],
“triggger”:[“workflow”,”approval”,”blueprint”]
}

レスポンス例:

+
バージョン1.0のレスポンスバージョン2.0のレスポンス
<?xml version="1.0" encoding="UTF-8" ?>
<response uri="/crm/private/xml/Leads/updateRecords">
<result>
<message>Record(s) updated successfully</message>
<recorddetail>
<FL val="Id">1386586000002577004</FL>
<FL val="Created Time">2018-03-2719:20:28</FL>
<FL val="Modified Time">2018-03-2810:56:54</FL>
<FL val="Created By"><![CDATA[Bruce Wills]]></FL>
<FL val="Modified By"><![CDATA[Bruce Wills]]></FL>
</recorddetail>
</result>
</response>
{
  "data": [
   {
    "code": "SUCCESS",
    "details": {
     "Modified_Time": "2018-03-27T19:20:28+05:30",
     "Modified_By": {
      "name": "Bruce Wills",
      "id": "1386586000000078001"
     },
     "Created_Time": "2018-03-27T19:20:28+05:30",
     "id": "1386586000002577004",
     "Created_By": {
      "name": "Bruce Wills",
      "id": "1386586000000078001"
     }
    },
    "message": "record updated",
    "status": "success",
   }   ]  }
 

v1.0 APIの"id"項目は、JSON配列の最初のJSONオブジェクトの"id"に相当します。

複数のデータを更新するには:

URL:

https://www.zohoapis.com/crm/v2/Leads

メソッド:PUT

リクエストボディ:JSON形式

ヘッダー:Authorization=Zoho-oauthtoken {oauth_token}

入力例:

{
  "data": [
    {
      "Last_Name":"test2",
      "Company":"com2",
      “id”:”1386586000002577004”
    },
    {
      "Last_Name":"test3",
      "Company":"com3",
      “id”:”1386586000002577006”
    },
...
  ]
}