Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

BatchUpdate may be used for more than just setting metadata on assets. It may also be used for creating combo values

...

Method : POST

Auth required : NO Yes

Required parameters

NameExampleDescription
accessKeyeb774621-1c2f-467b-b006-a8efa67094a7accessKey that grants access to the API

...

Code Block
[{
	"Id": "MetaDataUpdate0",
	"FieldId": "MetaDataUpdate0",
	"ContainerType": 1,
	"RowId": 1,
	"Values": [{
		"FieldId": "item_metafield_labelid",
		"Type": 3,
		"Values": [51867]
	},
	{
		"FieldId": "combovalue",
		"Type": 1,
		"Values": ["test 3"]
	},
	{
		"FieldId": "optionvalue",
		"Type": 1,
		"Values": ["3"]
	},
	{
		"FieldId": "sortindex",
		"Type": 3,
		"Values": [0]
	},
	{
		"FieldId": "ispublic",
		"Type": 2,
		"Values": [true]
	},
	{
		"FieldId": "visible",
		"Type": 2,
		"Values": [true]
	}],
	"BaseId": 0
}]

NOTE: The important parts to change in this example is the combovalue which refers to the name of the combovalue, the optionvalue which refers to a unique id for it (it may be the same as the name) and the item_metafield_labelid which refers to the language version combo on which the value should be created.

cUrl data example

Info
iconfalse

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 <r><metacombo_definition fieldId="MetaDataUpdate"><metafield MetaDataUpdate0"><item_metafield_labelid fieldId="MetaFieldLabeliditem_metafield_50723labelid" labelId/><combovalue fieldId="50723combovalue"/><metafield ><optionvalue fieldId="MetaFieldLabelid_51867" labelIdoptionvalue"/><sortindex fieldId="51867sortindex"/><metafield ><ispublic fieldId="MetaFieldLabelid_51876" labelIdispublic"/><visible fieldId="51876visible"/></asset><metacombo_definition></r>' \
-F 'values=[{"Id":"MetaDataUpdateMetaDataUpdate0","FieldId":"MetaDataUpdateMetaDataUpdate0","ContainerType":71,"RowId":1,"Values":[{"FieldId":"MetaFieldLabelid_50723item_metafield_labelid","Type":3,"Values":[51867]},{"FieldId":"combovalue","Type":1,"Values":["Desert title 2test 3"]},{"FieldId":"MetaFieldLabelid_51867optionvalue","Type":61,"Values":[51603"3"]},{"FieldId":"MetaFieldLabelid_51876sortindex","Type":173,"Values":["test 1"]}],"ItemIds":["10313"]0]},{"FieldId":"ispublic","Type":2,"Values":[true]},{"FieldId":"visible","Type":2,"Values":[true]}],"BaseId":0}]'

Success Response

Code : 200 OK

Content example

Code Block
languagejs
{
	"success": true,
	"total": 0,
	"error": "",
	"items": [{
		"Id": "MetaDataUpdateMetaDataUpdate0",
		"FieldId": "MetaDataUpdateMetaDataUpdate0",
		"ItemId": 1031310600,
		"BaseId": 11351637,
		"TestFase": false,
		"VersionId": null,
		"ChangesetId": 0,
		"Warnings": []
	}],
	"warnings": []
}

Error Response

Code : 200 OK

Content  example

...