twitter4j.api
Interface AccountMethods

All Known Subinterfaces:

Twitter

All Known Implementing Classes:

TwitterImpl

public interface AccountMethods

Author:

Joern Huxhorn - jhuxhorn at googlemail.com

Method Summary

AccountSettings	getAccountSettings() Returns the current trend, geo and sleep time information for the authenticating user.
AccountTotals	getAccountTotals() Returns the current count of friends, followers, updates (statuses) and favorites of the authenticating user.
RateLimitStatus	getRateLimitStatus() Returns the remaining number of API requests available to the requesting user before the API limit is reached for the current hour.
User	updateProfile(java.lang.String name, java.lang.String url, java.lang.String location, java.lang.String description) Sets values that users are able to set under the "Account" tab of their settings page.
User	updateProfileBackgroundImage(java.io.File image, boolean tile) Updates the authenticating user's profile background image.
User	updateProfileBackgroundImage(java.io.InputStream image, boolean tile) Updates the authenticating user's profile background image.
User	updateProfileColors(java.lang.String profileBackgroundColor, java.lang.String profileTextColor, java.lang.String profileLinkColor, java.lang.String profileSidebarFillColor, java.lang.String profileSidebarBorderColor) Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.com.
User	updateProfileImage(java.io.File image) Updates the authenticating user's profile image.
User	updateProfileImage(java.io.InputStream image) Updates the authenticating user's profile image.
User	verifyCredentials() Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not.

Method Detail

verifyCredentials

User verifyCredentials()
                       throws TwitterException

Returns an HTTP 200 OK response code and a representation of the requesting user if authentication was successful; returns a 401 status code and an error message if not. Use this method to test if supplied user credentials are valid.
This method calls http://api.twitter.com/1/account/verify_credentials.json

Returns:

user

Throws:

TwitterException - when Twitter service or network is unavailable, or if supplied credential is wrong (TwitterException.getStatusCode() == 401)

Since:

Twitter4J 2.0.0

See Also:

GET account/verify_credentials | dev.twitter.com

getRateLimitStatus

RateLimitStatus getRateLimitStatus()
                                   throws TwitterException

Returns the remaining number of API requests available to the requesting user before the API limit is reached for the current hour. Calls to rate_limit_status do not count against the rate limit. If authentication credentials are provided, the rate limit status for the authenticating user is returned. Otherwise, the rate limit status for the requester's IP address is returned.

This method calls http://api.twitter.com/1/account/rate_limit_status.json

Returns:

the rate limit status

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 1.1.4

See Also:

GET account/rate_limit_status | dev.twitter.com

updateProfileColors

User updateProfileColors(java.lang.String profileBackgroundColor,
                         java.lang.String profileTextColor,
                         java.lang.String profileLinkColor,
                         java.lang.String profileSidebarFillColor,
                         java.lang.String profileSidebarBorderColor)
                         throws TwitterException

Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.com. Each parameter's value must be a valid hexidecimal value, and may be either three or six characters (ex: #fff or #ffffff).
This method calls http://api.twitter.com/1/account/update_profile_colors.json

Parameters:

profileBackgroundColor - optional, can be null

profileTextColor - optional, can be null

profileLinkColor - optional, can be null

profileSidebarFillColor - optional, can be null

profileSidebarBorderColor - optional, can be null

Returns:

the updated user

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.0.0

See Also:

POST account/update_profile_colors | dev.twitter.com

updateProfileImage

User updateProfileImage(java.io.File image)
                        throws TwitterException

Updates the authenticating user's profile image.
This method calls http://api.twitter.com/1/account/update_profile_image.json

Parameters:

image - Must be a valid GIF, JPG, or PNG image of less than 700 kilobytes in size. Images with width larger than 500 pixels will be scaled down.

Returns:

the updated user

Throws:

TwitterException - when Twitter service or network is unavailable, or when the specified file is not found (FileNotFoundException will be nested), or when the specified file object in not representing a file (IOException will be nested)

Since:

Twitter4J 2.1.0

See Also:

POST account/update_profile_image | dev.twitter.com

updateProfileImage

User updateProfileImage(java.io.InputStream image)
                        throws TwitterException

Updates the authenticating user's profile image.
This method calls http://api.twitter.com/1/account/update_profile_image.json

Parameters:

image - Must be a valid GIF, JPG, or PNG image of less than 700 kilobytes in size. Images with width larger than 500 pixels will be scaled down.

Returns:

the updated user

Throws:

TwitterException - when Twitter service or network is unavailable, or when the specified file is not found (FileNotFoundException will be nested), or when the specified file object in not representing a file (IOException will be nested)

Since:

Twitter4J 2.1.11

See Also:

POST account/update_profile_image | dev.twitter.com

updateProfileBackgroundImage

User updateProfileBackgroundImage(java.io.File image,
                                  boolean tile)
                                  throws TwitterException

Updates the authenticating user's profile background image.
This method calls http://api.twitter.com/1/account/update_profile_background_image.json

Parameters:

image - Must be a valid GIF, JPG, or PNG image of less than 800 kilobytes in size. Images with width larger than 2048 pixels will be forceably scaled down.

tile - If set to true the background image will be displayed tiled. The image will not be tiled otherwise.

Returns:

the updated user

Throws:

TwitterException - when Twitter service or network is unavailable, or when the specified file is not found (FileNotFoundException will be nested), or when the specified file object in not representing a file (IOException will be nested)

Since:

Twitter4J 2.1.0

See Also:

POST account/update_profile_background_image | dev.twitter.com

updateProfileBackgroundImage

User updateProfileBackgroundImage(java.io.InputStream image,
                                  boolean tile)
                                  throws TwitterException

Updates the authenticating user's profile background image.
This method calls http://api.twitter.com/1/account/update_profile_background_image.json

Parameters:

image - Must be a valid GIF, JPG, or PNG image of less than 800 kilobytes in size. Images with width larger than 2048 pixels will be forceably scaled down.

tile - If set to true the background image will be displayed tiled. The image will not be tiled otherwise.

Returns:

the updated user

Throws:

TwitterException - when Twitter service or network is unavailable, or when the specified file is not found (FileNotFoundException will be nested), or when the specified file object in not representing a file (IOException will be nested)

Since:

Twitter4J 2.1.11

See Also:

POST account/update_profile_background_image | dev.twitter.com

updateProfile

User updateProfile(java.lang.String name,
                   java.lang.String url,
                   java.lang.String location,
                   java.lang.String description)
                   throws TwitterException

Sets values that users are able to set under the "Account" tab of their settings page. Only the parameters specified(non-null) will be updated.
This method calls http://api.twitter.com/1/account/update_profile.json

Parameters:

name - Optional. Maximum of 20 characters.

url - Optional. Maximum of 100 characters. Will be prepended with "http://" if not present.

location - Optional. Maximum of 30 characters. The contents are not normalized or geocoded in any way.

description - Optional. Maximum of 160 characters.

Returns:

the updated user

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.8

See Also:

POST account/update_profile | dev.twitter.com

getAccountTotals

AccountTotals getAccountTotals()
                               throws TwitterException

Returns the current count of friends, followers, updates (statuses) and favorites of the authenticating user.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/account/totals.json

Returns:

the current count of friends, followers, updates (statuses) and favorites of the authenticating user

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.9

See Also:

#newtwitter and the API - Twitter API Announcements | Google Group

getAccountSettings

AccountSettings getAccountSettings()
                                   throws TwitterException

Returns the current trend, geo and sleep time information for the authenticating user.
This method has not been finalized and the interface is subject to change in incompatible ways.
This method calls http://api.twitter.com/1/account/settings.json

Returns:

the current trend, geo and sleep time information for the authenticating user.

Throws:

TwitterException - when Twitter service or network is unavailable

Since:

Twitter4J 2.1.9

See Also:

#newtwitter and the API - Twitter API Announcements | Google Group