DC 5.8 [Deprecated] Setting metadata on an asset

Using BatchUpdateService is deprecated and will be removed in 6.0. Use DC 5.8 Updating asset metadata instead.

 

 

 

 

 

 

 

 

 

This explains how BatchUpdate is used for setting metadata on an asset. 



URL : /BatchUpdateService.js

Method : POST

Auth required : Yes

Required parameters

Name

Example

Description

Name

Example

Description

accessKey

eb774621-1c2f-467b-b006-a8efa67094a7

accessKey that grants access to the API

The updateXML and values is send as forms data and it looks like this:

updateXML

<r> <asset fieldId="MetaDataUpdate"> <metafield fieldId="MetaFieldLabelid_50723" labelId="50723"/> <metafield fieldId="MetaFieldLabelid_51867" labelId="51867"/> <metafield fieldId="MetaFieldLabelid_51876" labelId="51876"/> </asset> </r>



values

[{ "Id": "MetaDataUpdate", "FieldId": "MetaDataUpdate", "ContainerType": 7, "RowId": 1, "Values": [{ "FieldId": "MetaFieldLabelid_50723", "Type": 1, "Values": ["Desert title 2"] }, { "FieldId": "MetaFieldLabelid_51867", "Type": 6, "Values": [51603] }, { "FieldId": "MetaFieldLabelid_51876", "Type": 17, "Values": ["test 1"] }], "ItemIds": ["10313"] }]



*types

public enum ValueType     {         String = 1,         Bool = 2,         Int = 3,         DateTime = 4,         Float = 5,         IntList = 6,         Folder = 7,         AssetType = 8,         StringRow = 9,         BoolRow = 10,         IntRow = 11,         DateTimeRow = 12,         FloatRow = 13,         IntListRow = 14,         Delete = 15,         ValueExtraValue = 16,         StringList = 17,         StringListRow = 18     }



cUrl data example

curl -X POST \
'/dmm3bwsv3/BatchUpdateService.js?accesskey=eb774621-1c2f-467b-b006-a8efa67094a7' \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 2fc4dd60-8895-0341-5fed-46b57912981d' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F 'updateXML=<r><asset fieldId="MetaDataUpdate"><metafield fieldId="MetaFieldLabelid_50723" labelId="50723"/><metafield fieldId="MetaFieldLabelid_51867" labelId="51867"/><metafield fieldId="MetaFieldLabelid_51876" labelId="51876"/></asset></r>' \
-F 'values=[{"Id":"MetaDataUpdate","FieldId":"MetaDataUpdate","ContainerType":7,"RowId":1,"Values":[{"FieldId":"MetaFieldLabelid_50723","Type":1,"Values":["Desert title 2"]},{"FieldId":"MetaFieldLabelid_51867","Type":6,"Values":[51603]},{"FieldId":"MetaFieldLabelid_51876","Type":17,"Values":["test 1"]}],"ItemIds":["10313"]}]'

Success Response

Code : 200 OK

Content example

Error Response

Code : 200 OK

Content  example