addTagsToAsset

Go to: Parameters | Return | Example | Correct return

AddTagsToAsset assigns tags to an asset. AddTagsToAsset returns a regular response, with the updated item feed. To add tags of type campaign-tag, the user must have special permissions by the partner. Otherwise an error is generated. Any user can add UGC tags if the partner application itself permits it.

Parameters

Parameter	Description
token	The User token retrieved from loginAsEndUser.
item	The asset id
tags	A comma-separated list of descriptive words for the asset. There must be at least one tag.
tagType	tagType retrieves the tag types. The tag types are: TAG_TYPE_UGC = 1 TAG_TYPE_SYSTEM = 2 TAG_TYPE_CAMPAIGN = 3 TAG_TYPE_CAMPAIGN tags are defined by the partner, and are reserved for users with special partner permission.
replaceAll	replaceAll replaces all existing tags, before adding new tags. The values are 1 (true) or 0 (false).

back to top

Return

Feed entry of the asset after the update (See Appendix C for specific explanations)

back to top

Example

http://www.gizmoz.com/axis2/services/GizmozCatalog/addTagsToAsset?token=<UserToken><PartnerToken><PartnerName>studio</PartnerName><PartnerTransactionId>16</PartnerTransactionId><ApplicationName>studio</ApplicationName></PartnerToken><UserId>13632_1233647488953</UserId></UserToken>&item= 155802 &tags=happy,joy,sunshine&tagType=1&replaceAll=undefined

back to top

Correct Return

<ns:addTagsToAssetResponse>

<ns:return type="gizmoz.api.data.catalog.CatalogResult">

<ax21:errorMsg/>

<ax21:rc>1</ax21:rc>

<ax21:catalogDetails>

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:asset="http://www.gizmoz.com/api/module/item/1.0.rdf" xmlns:comment="http://www.gizmoz.com/api/module/comment/1.0.rdf" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" xmlns:taxo="http://purl.org/rss/1.0/modules/taxonomy/" xmlns:user="http://www.gizmoz.com/api/module/category/1.0.rdf"><title>Tags:news</title><id>*,*</id><generator uri="http://api.gizmoz.com" version="1.0">Gizmoz API - GAWS</generator><updated>2009-02-15T08:42:27Z</updated><opensearch:itemsPerPage>0</opensearch:itemsPerPage><opensearch:totalResults>1</opensearch:totalResults><opensearch:startIndex>1</opensearch:startIndex><opensearch:Query role="" searchTerms="assetType:null,assetSubType:*"/><entry><title>welcome sample</title><author><name>13632</name></author><id> 12289926 </id><updated>2009-02-15T08:02:00Z</updated><published>2009-02-15T08:02:00Z</published><asset:group><asset:type>material</asset:type><asset:subtype>studio_scene</asset:subtype><asset:attribs><root><externalattrs><General duration="20718"/></externalattrs></root></asset:attribs><asset:content format="text/xml" url="http://www.gizmoz.com/file/material/13632/studio_scene/12289926.xml?v=1234687193689"/><asset:thumbnail format="image/jpeg" url="http://www.gizmoz.com/file/material/1/image/default.jpg?v=1225981080000"/><asset:tags tag="news" type="1"/><asset:authorname>capiright</asset:authorname><asset:authorid>13632</asset:authorid><asset:authorization>public</asset:authorization></asset:group></entry></feed>

</ax21:catalogDetails>

</ns:return>

</ns:addTagsToAssetResponse>

</ns:addTagsToAssetResponse>

back to top