facebook4j.api

Interface AlbumMethods

All Known Subinterfaces:

Facebook

All Known Implementing Classes:

FacebookImpl

public interface AlbumMethods

Author:

Ryuji Yamashita - roundrop at gmail.com

Method Summary

Modifier and Type	Method and Description
java.lang.String	addAlbumPhoto(java.lang.String albumId, Media source) Adds a photo to the album.
java.lang.String	addAlbumPhoto(java.lang.String albumId, Media source, java.lang.String message) Adds a photo to the album.
java.lang.String	commentAlbum(java.lang.String albumId, CommentUpdate commentUpdate) Comments on the album.
java.lang.String	commentAlbum(java.lang.String albumId, java.lang.String message) Comments on the album.
java.lang.String	createAlbum(AlbumUpdate albumUpdate) Creates the current user's photo album.
java.lang.String	createAlbum(java.lang.String userId, AlbumUpdate albumUpdate) Creates the user's photo album.
Album	getAlbum(java.lang.String albumId) Returns a single photo album.
Album	getAlbum(java.lang.String albumId, Reading reading) Returns a single photo album.
ResponseList<Comment>	getAlbumComments(java.lang.String albumId) Returns the comments made on the album.
ResponseList<Comment>	getAlbumComments(java.lang.String albumId, Reading reading) Returns the comments made on the album.
java.net.URL	getAlbumCoverPhoto(java.lang.String albumId) Returns url of the album's cover photo.
ResponseList<Like>	getAlbumLikes(java.lang.String albumId) Returns likes made on the album.
ResponseList<Like>	getAlbumLikes(java.lang.String albumId, Reading reading) Returns likes made on the album.
ResponseList<Photo>	getAlbumPhotos(java.lang.String albumId) Returns the photos contained in the album.
ResponseList<Photo>	getAlbumPhotos(java.lang.String albumId, Reading reading) Returns the photos contained in the album.
ResponseList<Album>	getAlbums() Returns the photo albums the current user/page has created.
ResponseList<Album>	getAlbums(Reading reading) Returns the photo albums the current user/page has created.
ResponseList<Album>	getAlbums(java.lang.String id) Returns the photo albums a user/page has created.
ResponseList<Album>	getAlbums(java.lang.String id, Reading reading) Returns the photo albums a user/page has created.
boolean	likeAlbum(java.lang.String albumId) Likes the album.
boolean	unlikeAlbum(java.lang.String albumId) Unlikes the album.

Method Detail

getAlbums

ResponseList<Album> getAlbums()
                       throws FacebookException

Returns the photo albums the current user/page has created.

Returns:

albums

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

User - Facebook Developers - Connections - albums

getAlbums

ResponseList<Album> getAlbums(Reading reading)
                       throws FacebookException

Returns the photo albums the current user/page has created.

Parameters:

reading - optional reading parameters. see Graph API#reading - Facebook Developers

Returns:

albums

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

User#albums - Facebook Developers

getAlbums

ResponseList<Album> getAlbums(java.lang.String id)
                       throws FacebookException

Returns the photo albums a user/page has created.

Parameters:

id - the ID of a user/page

Returns:

albums

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

User#albums - Facebook Developers

getAlbums

ResponseList<Album> getAlbums(java.lang.String id,
                              Reading reading)
                       throws FacebookException

Returns the photo albums a user/page has created.

Parameters:

id - the ID of a user/page

reading - optional reading parameters. see Graph API#reading - Facebook Developers

Returns:

albums

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

User#albums - Facebook Developers

createAlbum

java.lang.String createAlbum(AlbumUpdate albumUpdate)
                      throws FacebookException

Creates the current user's photo album.

Parameters:

albumUpdate - the album to be created

Returns:

The new album ID

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

User#albums - Facebook Developers

createAlbum

java.lang.String createAlbum(java.lang.String userId,
                             AlbumUpdate albumUpdate)
                      throws FacebookException

Creates the user's photo album.

Parameters:

userId - the ID of a user

albumUpdate - the album to be created

Returns:

The new album ID

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

User#albums - Facebook Developers

getAlbum

Album getAlbum(java.lang.String albumId)
        throws FacebookException

Returns a single photo album.

Parameters:

albumId - the ID of a album

Returns:

album

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album - Facebook Developers

getAlbum

Album getAlbum(java.lang.String albumId,
               Reading reading)
        throws FacebookException

Returns a single photo album.

Parameters:

albumId - the ID of a album

reading - optional reading parameters. see Graph API#reading - Facebook Developers

Returns:

album

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album - Facebook Developers

getAlbumPhotos

ResponseList<Photo> getAlbumPhotos(java.lang.String albumId)
                            throws FacebookException

Returns the photos contained in the album.

Parameters:

albumId - the ID of a album

Returns:

photos

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#photos - Facebook Developers

getAlbumPhotos

ResponseList<Photo> getAlbumPhotos(java.lang.String albumId,
                                   Reading reading)
                            throws FacebookException

Returns the photos contained in the album.

Parameters:

albumId - the ID of a album

reading - optional reading parameters. see Graph API#reading - Facebook Developers

Returns:

photos

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#photos - Facebook Developers

addAlbumPhoto

java.lang.String addAlbumPhoto(java.lang.String albumId,
                               Media source)
                        throws FacebookException

Adds a photo to the album.

Parameters:

albumId - the ID of a album

source - photo content

Returns:

The new photo ID

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#photos - Facebook Developers

addAlbumPhoto

java.lang.String addAlbumPhoto(java.lang.String albumId,
                               Media source,
                               java.lang.String message)
                        throws FacebookException

Adds a photo to the album.

Parameters:

albumId - the ID of a album

source - photo content

message - photo description

Returns:

The new photo ID

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#photos - Facebook Developers

getAlbumComments

ResponseList<Comment> getAlbumComments(java.lang.String albumId)
                                throws FacebookException

Returns the comments made on the album.

Parameters:

albumId - the ID of a album

Returns:

comments

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#comments - Facebook Developers

getAlbumComments

ResponseList<Comment> getAlbumComments(java.lang.String albumId,
                                       Reading reading)
                                throws FacebookException

Returns the comments made on the album.

Parameters:

albumId - the ID of a album

reading - optional reading parameters. see Graph API#reading - Facebook Developers

Returns:

comments

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#comments - Facebook Developers

commentAlbum

java.lang.String commentAlbum(java.lang.String albumId,
                              java.lang.String message)
                       throws FacebookException

Comments on the album.

Parameters:

albumId - the ID of a album

message - comment text

Returns:

The new comment ID

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#comments - Facebook Developers

commentAlbum

java.lang.String commentAlbum(java.lang.String albumId,
                              CommentUpdate commentUpdate)
                       throws FacebookException

Comments on the album.

Parameters:

albumId - the ID of a album

commentUpdate - comment content

Returns:

The new comment ID

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#comments - Facebook Developers

getAlbumLikes

ResponseList<Like> getAlbumLikes(java.lang.String albumId)
                          throws FacebookException

Returns likes made on the album.

Parameters:

albumId - the ID of a album

Returns:

likes

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#likes - Facebook Developers

getAlbumLikes

ResponseList<Like> getAlbumLikes(java.lang.String albumId,
                                 Reading reading)
                          throws FacebookException

Returns likes made on the album.

Parameters:

albumId - the ID of a album

reading - optional reading parameters. see Graph API#reading - Facebook Developers see Graph API#reading - Facebook Developers

Returns:

likes

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#likes - Facebook Developers

likeAlbum

boolean likeAlbum(java.lang.String albumId)
           throws FacebookException

Likes the album.

Parameters:

albumId - the ID of a album

Returns:

true if like is successful

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#likes - Facebook Developers

unlikeAlbum

boolean unlikeAlbum(java.lang.String albumId)
             throws FacebookException

Unlikes the album.

Parameters:

albumId - the ID of a album

Returns:

true if unlike is successful

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album#likes - Facebook Developers

getAlbumCoverPhoto

java.net.URL getAlbumCoverPhoto(java.lang.String albumId)
                         throws FacebookException

Returns url of the album's cover photo.

Parameters:

albumId - the ID of a album

Returns:

url

Throws:

FacebookException - when Facebook service or network is unavailable

See Also:

Album - Facebook Developers - Connections - picture