1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
|
require 'twitter/arguments'
require 'twitter/rest/utils'
require 'twitter/suggestion'
require 'twitter/user'
module Twitter
module REST
module SuggestedUsers
include Twitter::REST::Utils
# @return [Array<Twitter::Suggestion>]
# @rate_limited Yes
# @authentication Requires user context
# @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
# @overload suggestions(options = {})
# Returns the list of suggested user categories
#
# @see https://dev.twitter.com/rest/reference/get/users/suggestions
# @param options [Hash] A customizable set of options.
# @overload suggestions(slug, options = {})
# Returns the users in a given category
#
# @see https://dev.twitter.com/rest/reference/get/users/suggestions/:slug
# @param slug [String] The short name of list or a category.
# @param options [Hash] A customizable set of options.
def suggestions(*args)
arguments = Twitter::Arguments.new(args)
if arguments.last
perform_get_with_object("/1.1/users/suggestions/#{arguments.pop}.json", arguments.options, Twitter::Suggestion)
else
perform_get_with_objects('/1.1/users/suggestions.json', arguments.options, Twitter::Suggestion)
end
end
# Access the users in a given category of the Twitter suggested user list and return their most recent Tweet if they are not a protected user
#
# @see https://dev.twitter.com/rest/reference/get/users/suggestions/:slug/members
# @rate_limited Yes
# @authentication Requires user context
# @param slug [String] The short name of list or a category.
# @param options [Hash] A customizable set of options.
# @return [Array<Twitter::User>]
def suggest_users(slug, options = {})
perform_get_with_objects("/1.1/users/suggestions/#{slug}/members.json", options, Twitter::User)
end
end
end
end
|