com.podio.tag

Class TagAPI

java.lang.Object

com.podio.BaseAPI

com.podio.tag.TagAPI

public class TagAPI
extends BaseAPI

Tags are words or short sentences that are used as metadata for objects. For a more detailed explanation, see this wikipedia article: http://en.wikipedia.org/wiki/Tag_(metadata) Podio supports tags on statuses and items and tags that include spaces.

Constructor Summary

Constructors

Constructor and Description
TagAPI(ResourceFactory resourceFactory)

Method Summary

Methods

Modifier and Type	Method and Description
void	createTags(Reference reference, Collection<String> tags) Add a new set of tags to the object.
void	createTags(Reference reference, String... tags) Add a new set of tags to the object.
List<TagCount>	getTagsOnApp(int appId) Returns the tags on the given app.
List<TagReference>	getTagsOnAppWithText(int appId, String text) Returns the objects that are tagged with the given text on the app.
List<TagCount>	getTagsOnSpace(int spaceId) Returns the tags on the given space.
List<TagReference>	getTagsOnSpaceWithText(int spaceId, String text) Returns the objects that are tagged with the given text on the space.
void	removeTag(Reference reference, String tag) Removes a single tag from an object.
void	updateTags(Reference reference, Collection<String> tags) Update the tags on the objects
void	updateTags(Reference reference, String... tags) Update the tags on the objects

Methods inherited from class com.podio.BaseAPI

getResourceFactory

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TagAPI

public TagAPI(ResourceFactory resourceFactory)

Method Detail

createTags

public void createTags(Reference reference,
              Collection<String> tags)

Add a new set of tags to the object. If a tag with the same text is already present, the tag will be ignored.

Parameters:

reference - The object the tags should be added to

tags - The tags that should be added

createTags

public void createTags(Reference reference,
              String... tags)

Add a new set of tags to the object. If a tag with the same text is already present, the tag will be ignored.

Parameters:

reference - The object the tags should be added to

tags - The tags that should be added

updateTags

public void updateTags(Reference reference,
              Collection<String> tags)

Update the tags on the objects

Parameters:

reference - The object the tags should be updated on

tags - The tags that should now be set on the object

updateTags

public void updateTags(Reference reference,
              String... tags)

Update the tags on the objects

Parameters:

reference - The object the tags should be updated on

tags - The tags that should now be set on the object

removeTag

public void removeTag(Reference reference,
             String tag)

Removes a single tag from an object.

Parameters:

reference - The object the tag should be removed from

tag - The tag to remove

getTagsOnApp

public List<TagCount> getTagsOnApp(int appId)

Returns the tags on the given app. This includes only items. The tags are ordered firstly by the number of uses, secondly by the tag text.

Parameters:

appId - The id of the app to return tags from *

Returns:

The list of tags with their count

getTagsOnSpace

public List<TagCount> getTagsOnSpace(int spaceId)

Returns the tags on the given space. This includes both items and statuses. The tags are ordered firstly by the number of uses, secondly by the tag text.

Parameters:

spaceId - The id of the space to return tags from

Returns:

The list of tags with their count

getTagsOnAppWithText

public List<TagReference> getTagsOnAppWithText(int appId,
                                      String text)

Returns the objects that are tagged with the given text on the app. The objects are returned sorted descending by the time the tag was added.

Parameters:

appId - The id of the app to search within

text - The tag to search for

Returns:

The list of objects in the app that have the given tag

getTagsOnSpaceWithText

public List<TagReference> getTagsOnSpaceWithText(int spaceId,
                                        String text)

Returns the objects that are tagged with the given text on the space. The objects are returned sorted descending by the time the tag was added.

Parameters:

spaceId - The id of the space to search within

text - The tag to search for

Returns:

The list of objects in the space that have the given tag