com.adobe.cq.socialmedia

Interface SocialPublisher

public interface SocialPublisher

Defines a SocialPublisher which offers the possibility to interact with a SM network (ex.: post, delete).

Method Summary

Modifier and Type	Method and Description
void	delete(SocialPublisherDeleteParams params) Deletes a post from the SM network.
java.lang.String	getResponseCodeKey() Returns the OAuth response key.
java.util.List<SocialSpace>	getSocialSpaces() Retrieves the social spaces list for an user (ex.: pages he manages, boards he owns).
java.lang.String	publish(SocialPublisherPublishParams params) Posts image and text to a specific location on SM Network.
void	setResponseCode(java.lang.String responseCode) Sets response code from Oauth in order to gain access to SM methods.

Method Detail

publish

java.lang.String publish(SocialPublisherPublishParams params)
                  throws SocialException

Posts image and text to a specific location on SM Network.

Parameters:

params - containing: - pictureUrl - URL pointing to existing picture on the WEB OR picture - Picture as InputStream - description - Picture description - spaceId - Space where the picture will be posted (ex.:Page ID/ Board name)

Returns:

Post ID

Throws:

SocialException - Thrown if the post cannot be executed

delete

void delete(SocialPublisherDeleteParams params)
     throws SocialException

Deletes a post from the SM network.

Parameters:

params - containing: - postId - The ID of the post to be deleted - spaceId - Space where the post exists (ex.:Page ID/ Board name)

Throws:

SocialException - Thrown if the post cannot be deleted

setResponseCode

void setResponseCode(java.lang.String responseCode)

Sets response code from Oauth in order to gain access to SM methods.

Parameters:

responseCode - OAuth response code.

getResponseCodeKey

java.lang.String getResponseCodeKey()

Returns the OAuth response key.

Returns:

OAuth response key

getSocialSpaces

java.util.List<SocialSpace> getSocialSpaces()
                                     throws SocialException

Retrieves the social spaces list for an user (ex.: pages he manages, boards he owns).

Returns:

A list with spaces that the logged in user can modify.

Throws:

SocialException - Thrown if the social spaces cannot be retrieved.