*updateVideoTag

Configuration Article | CA-20220907-TP-75

VDG Sense | API | Functions | Video Tagging

Note: This function requires an API license.

Update the video tag title and/or comment field. If a field is omitted, it’s value remains unchanged.
Returns the changed videotag.

Request

command=updatevideotag&id=[UID]&title=[String]&comment=[String]

Response

<result errorcode="0">     <videotag>         <id>[UID]</id>         <serverid>[UID]</serverid> <!-- if zero tag is for all devices -->         <deviceid>[UID]</deviceid> <!-- if zero tag is for all devices -->         <startdate>[timestamp]</startdate> <videotagdate>[timestamp]</videotagdate>         <enddate>[timestamp]</enddate>         <title>[String]</title>         <comment>[String]</comment>     </videotag> </result>

node/result

value

remarks

node/result

value

remarks

/result

 

 

@errorcode

[number]

See error codes below

/result/videotag

 

 

id

[UID]

unique id

serverid

[UID]

unique server id

deviceid

[UID]

unique device id

startdate

[timestamp]

Tags with a (local) timestamp >= startdate (pretime) are returned.

videotagdate

[timestamp]

Tags with a (local) timestamp = videotagdate are returned.

enddate

[timestamp]

Tags with a (local) timestamp <= enddate (posttime) are returned.

title

[string]

A user defined title

comment

[string]

A user defined comment

error code

description

remarks

error code

description

remarks

0

Ok

Ok, no error

-18

General error

An undefined error occured

-26

Videotag does not exist

Videotag does not exist or can not be found

See Also

Changelog

  • 2.4.3 - Added

  • 2.7.3 - Added parameter videotagdate