twitter4s.api

UsersResources

trait UsersResources extends AnyRef

Linear Supertypes
AnyRef, Any
Known Subclasses
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. UsersResources
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def createBlock(specificUser: SpecificInfo): User

    Blocks the user specified in the ID parameter as the authenticating user.

    Blocks the user specified in the ID parameter as the authenticating user. Returns the blocked user in the requested format when successful.
    This method calls twitter4j.Twitter.createBlock(screenName) or createBlock(userId)
    createBlock calls http://api.twitter.com/1.1/blocks/create/[id].json
    Note1: You must set parameter screenName or userId at least.
    Note2: Parameter userId is taken priority over screenName.

    specificUser

    the user spcecific information of the user to block

    returns

    the blocked user

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    IllegalArgumentException

    when specificUser is set null.

    TwitterException

    when Twitter service or network is unavailable

    See also

    POST blocks/create | Twitter Developers

  2. abstract def destroyBlock(specificUser: SpecificInfo): User

    Un-blocks the user specified in the ID parameter as the authenticating user.

    Un-blocks the user specified in the ID parameter as the authenticating user. Returns the un-blocked user in the requested format when successful.
    This method calls twitter4j.Twitter.destroyBlock(screenName) or destroyBlock(userId)
    destroyBlock calls http://api.twitter.com/1.1/blocks/destroy/[id].json
    Note1: You must set parameter screenName or userId at least.
    Note2: Parameter userId is taken priority over screenName.

    specificUser

    the user spcecific information of the user to block

    returns

    the unblocked user

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    IllegalArgumentException

    when specificUser is set null.

    TwitterException

    when Twitter service or network is unavailable

    See also

    POST blocks/destroy | Twitter Developers

  3. abstract def getAccountSettings: AccountSettings

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

    Returns the current trend, geo, language, timezone 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 twitter4j.Twitter.getAccountSettings.
    getAccountSettings calls http://api.twitter.com/1.1/account/settings.json

    returns

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

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET account/settings | Twitter Developers

  4. abstract def getBlocksIDs(cursor: Long = null): IDs

    Returns an array of numeric user ids the authenticating user is blocking.

    Returns an array of numeric user ids the authenticating user is blocking.
    This method calls twitter4j.Twitter.getBlockingUsersIDs
    getBlockingUsersIDs calls http://api.twitter.com/1.1/blocks/ids

    returns

    Returns an array of numeric user ids the authenticating user is blocking.

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET blocks/blocking/ids | Twitter Developers

  5. abstract def getBlocksList(cursor: Long = null): PagableResponseList[twitter4j.User]

    Returns a list of user objects that the authenticating user is blocking.

    Returns a list of user objects that the authenticating user is blocking.
    This method calls twitter4j.Twitter.getBlocksList() or getBlocksList(page)
    getBlockingUsers calls http://api.twitter.com/1.1/blocks/blocking.json

    cursor

    (optional) the number of page

    returns

    a list of user objects that the authenticating user

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET blocks/blocking | Twitter Developers

  6. abstract def getContributees(specificUser: SpecificInfo): ResponseList[twitter4j.User]

    Returns an array of users that the specified user can contribute to.

    Returns an array of users that the specified user can contribute to.
    This method calls twitter4j.Twitter.getContributees.

    specificUser

    The user id or screen name of the user for whom to return results for

    returns

    list of contributors

    Since

    Twitter4S 2.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET users/contributors | Twitter Developers

  7. abstract def getContributors(specificUser: SpecificInfo): ResponseList[twitter4j.User]

    Returns an array of users who can contribute to the specified account.

    Returns an array of users who can contribute to the specified account.
    This method calls twitter4j.Twitter.getContributors.

    specificUser

    The user id or screen name of the user for whom to return results for

    returns

    list of contributors

    Since

    Twitter4S 2.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET users/contributors | Twitter Developers

  8. abstract def lookupUsers(specificUsers: SpecificInfo): ResponseList[twitter4j.User]

    Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two.

    Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two. The author's most recent status (if the authenticating user has permission) will be returned inline.
    This method calls twitter4j.Twitter.lookupUsers.
    lookupUsers calls http://api.twitter.com/1.1/users/lookup.json
    Note1: You must set screenNames or ids at least.
    Note2: Parameter ids is taken priority over screenNames.

    specificUsers

    (optional) user specific information(screen names or ids) to return

    returns

    users

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET users/lookup | Twitter Developers

  9. abstract def removeProfileBanner(): Unit

    Removes the uploaded profile banner for the authenticating user.

    Removes the uploaded profile banner for the authenticating user. Returns HTTP 200 upon success.
    This method calls https://api.twitter.com/1.1/account/remove_profile_banner.json
    This method calls twitter4j.Twitter.removeProfileBanner

    Since

    Twitter4S 2.0.0

    See also

    POST account/remove_profile_banner | Twitter Developers

  10. abstract def searchUsers(query: String, page: Int): ResponseList[twitter4j.User]

    Run a search for users similar to the Find People button on Twitter.

    Run a search for users similar to the Find People button on Twitter.com; the same results returned by people search on Twitter.com will be returned by using this API.
    Usage note: It is only possible to retrieve the first 1000 matches from this API.
    This method calls twitter4j.Twitter.searchUsers.
    searchUsers calls http://api.twitter.com/1.1/users/search.json

    query

    The query to run against people search.

    page

    Specifies the page of results to retrieve. Number of statuses per page is fixed to 20.

    returns

    the list of Users matches the provided

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    GET users/search | Twitter Developers

  11. abstract def showUser(specificUser: SpecificInfo): User

    Returns extended information of a given user, specified by ID or screen name as per the required id parameter.

    Returns extended information of a given user, specified by ID or screen name as per the required id parameter. The author's most recent status will be returned inline.
    This method calls twitter4j.Twitter.showUser.
    showUser calls http://api.twitter.com/1.1/users/show.json
    Note1: You must set screenName or userId at least.
    Note2: Parameter userId is taken priority over screenName.

    specificUser

    (required) the user specific information(screen name or ID) for whom to request the detail

    returns

    users

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    IllegalArgumentException

    when specificUser is set null.

    TwitterException

    when Twitter service or network is unavailable

    See also

    GET users/show | Twitter Developers

  12. abstract def updateAccountSettings(trendLocationWoeid: Integer = null, sleepTimeEnabled: Boolean = null, startSleepTime: String = null, endSleepTime: String = null, timeZone: String = null, lang: String = null): AccountSettings

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

    Updates the current trend, geo, language, timezone 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 twitter4j.Twitter.updateAccountSettings.
    updateAccountSettings calls http://api.twitter.com/1.1/account/settings.json

    trendLocationWoeid

    Optional. The Yahoo! Where On Earth ID to use as the user's default trend location.

    sleepTimeEnabled

    Optional. Whether sleep time is enabled for the user

    startSleepTime

    Optional. The hour that sleep time should begin if it is enabled.

    endSleepTime

    Optional. The hour that sleep time should end if it is enabled.

    timeZone

    Optional. The timezone dates and times should be displayed in for the user.

    lang

    Optional. The language which Twitter should render in for this user. (two letter ISO 639-1)

    returns

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

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    POST account/settings | Twitter Developers

  13. abstract def updateProfile(name: String = null, url: String = null, location: String = null, description: String = null): User

    Sets values that users are able to set under the "Account" tab of their settings page.

    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 twitter4j.Twitter.updateProfile.
    updateProfile calls http://api.twitter.com/1.1/account/update_profile.json

    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

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    POST account/update_profile | Twitter Developers

  14. abstract def updateProfileBackgroundImage(imageResource: SpecificResource, tile: Boolean): User

    Updates the authenticating user's profile background image.

    Updates the authenticating user's profile background image.

    This method calls twitter4.Twitter.updateProfileBackgroundImage.
    updateProfileBackgroundImage method calls http://api.twitter.com/1.1/account/update_profile_background_image.json
    Note: You must set prameter imageFile or imageStream at least.
    Background 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.

    imageResource

    (require) Background image as File or Stream object.

    tile

    (required) If set to true the background image will be displayed tiled. The image will not be tiled otherwise.

    returns

    the updated user

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    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)

    See also

    POST account/update_profile_background_image | Twitter Developers

  15. abstract def updateProfileBanner(imageResource: SpecificResource): Unit

    Uploads a profile banner on behalf of the authenticating user.

    Uploads a profile banner on behalf of the authenticating user. For best results, upload an <5MB image that is exactly 1252px by 626px. Images will be resized for a number of display options. Users with an uploaded profile banner will have a profile_banner_url node in their Users objects. More information about sizing variations can be found in User Profile Images and Banners.
    Profile banner images are processed asynchronously. The profile_banner_url and its variant sizes will not necessary be available directly after upload.

    This method calls https://api.twitter.com/1.1/account/update_profile_banner.json
    This method calls twitter4j.Twitter.updateProfileBanner

    imageResource

    (File or FileStream) For best results, upload an <5MB image that is exactly 1252px by 626px.

    Since

    Twitter4S 2.0.0

    Exceptions thrown
    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)

    See also

    POST account/update_profile_banner | Twitter Developers

  16. abstract def updateProfileColors(profileBackgroundColor: String = null, profileTextColor: String = null, profileLinkColor: String = null, profileSidebarFillColor: String = null, profileSidebarBorderColor: String = null): User

    Sets one or more hex values that control the color scheme of the authenticating user's profile page on twitter.

    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 twitter4j.Twitter.updateProfileColors.
    updateProfileColors calls http://api.twitter.com/1.1/account/update_profile_colors.json

    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

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    TwitterException

    when Twitter service or network is unavailable

    See also

    POST account/update_profile_colors | Twitter Developers

  17. abstract def updateProfileImage(imageResource: SpecificResource): User

    Updates the authenticating user's profile image.

    Updates the authenticating user's profile image.

    This method calls twitter4j.Twitter.updateProfileImage.
    updateProfileImage calls http://api.twitter.com/1.1/account/update_profile_image.json
    Note: You must set parameter imageFile or imageStream at least.
    Profile 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.

    imageResource

    (require) Profile image as File or Stream object.

    returns

    the updated user

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    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).

    See also

    POST account/update_profile_image | Twitter Developers

  18. abstract def verifyCredentials: User

    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.

    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 twitter4j.Twitter.verifyCredentials.
    verifyCredentials calls http://api.twitter.com/1.1/account/verify_credentials.json

    returns

    user

    Since

    Twitter4S 1.0.0

    Exceptions thrown
    twitter4j.TwitterException

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

    See also

    GET account/verify_credentials | Twitter Developers

Concrete Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  7. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  8. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  9. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  10. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  11. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  12. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  13. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  14. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  15. final def notify(): Unit

    Definition Classes
    AnyRef
  16. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  17. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  18. def toString(): String

    Definition Classes
    AnyRef → Any
  19. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  20. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  21. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped