Add
set of tags to a particular presentation.
Request URL: POST
Method
XML :
http://show.zoho.com/api/private/xml/addTags/[presentationID]?apikey=[API Key]&ticket=[Ticket]
JSON : http://show.zoho.com/api/private/json/addTags/[presentationID]?apikey=[API Key]&ticket=[Ticket]
Request parameters :
To add a set of tags to a
particular presentation we need to submit
a form
data to Show with the following fields:
Field
|
Description
|
presentationId
|
Unique ID of the presentation for
which tags are to be added.
|
tags
|
[string] - One or more tag(s) to be
associated with this presentation. For adding multiple tags, separate them by
'space'. |
Sample Form (POST Method)
<form method="POST"
action="http://show.zoho.com/api/private/xml/addTags/[presentationId]?apikey=[APIKEY]&ticket=[Ticket]">
<input type="hidden" name="tagname" value="tag1 tag2 tag3">
<input type="submit" value="AddTag" class="divbutton"
name="submit">
</form>
* It is mandatory to pass the apikey and
ticket parameters to access the addTags api.
Response fields
The schema presentation for the API response is located at: http://show.zoho.com/schema/api/addtags.xsd
Field
|
Description
|
presentationId
|
Unique ID associated with the
presentation.
|
tag
|
Name of one or more tag(s) that is
being associated with the presentation. |
tag name
|
List of tag names for the
presentation
|
Sample Response
The following is the
sample XML response for the above method:
<?xml version="1.0" encoding="UTF-8" ?>
<response uri="/api/private/xml/addTags/8892000000064009">
<result>
<presentationId>8892000000064009</presentationId>
<tag>
<tag name="search" />
<tag
name="forecast" />
<tag name="figures" />
</tag>
</result>
</response>
Equivalent JSON response
{
"response":
{
"uri": "/api/private/json/addTags/8892000000064009",
"result":
{
"presentationId":"8892000000064009",
"tags":
{
"tag":
[
{
"name":"search"
},
{
"name":"forecast"
},
{
"name":"figures"
}
]
}
}
}
}
Errors
Adding a set of tags
to a presentation method may return general errors. Other HTTP error
code may be 3404.
