Module Twitter::Client::Favorites
In: lib/twitter/client/favorites.rb

Defines methods related to favorites (or favourites)

Methods

Public Instance methods

Favorites the specified status as the authenticating user

@see dev.twitter.com/docs/api/1/post/favorites/create/:id @rate_limited No @requires_authentication Yes @param id [Integer] The numerical ID of the desired status. @param options [Hash] A customizable set of options. @option options [Boolean, String, Integer] :include_entities Include {dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, ‘t’ or 1. @return [Twitter::Status] The favorited status. @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid. @example Favorite the status with the ID 25938088801

  Twitter.favorite(25938088801)
favorite_create(id, options={})

Alias for favorite

favorite_destroy(id, options={})

Alias for unfavorite

@see dev.twitter.com/docs/api/1/get/favorites @rate_limited Yes @requires_authentication No @overload favorites(options={})

  Returns the 20 most recent favorite statuses for the authenticating user

  @param options [Hash] A customizable set of options.
  @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 100.
  @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
  @option options [Integer] :page Specifies the page of results to retrieve.
  @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
  @return [Array<Twitter::Status>] favorite statuses.
  @example Return the 20 most recent favorite statuses for the authenticating user
    Twitter.favorites

@overload favorites(user, options={})

  Returns the 20 most recent favorite statuses for the specified user

  @param user [Integer, String] A Twitter user ID or screen name.
  @param options [Hash] A customizable set of options.
  @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 100.
  @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
  @option options [Integer] :page Specifies the page of results to retrieve.
  @return [Array<Twitter::Status>] favorite statuses.
  @example Return the 20 most recent favorite statuses for @sferik
    Twitter.favorites("sferik")

Un-favorites the specified status as the authenticating user

@see dev.twitter.com/docs/api/1/post/favorites/destroy/:id @rate_limited No @requires_authentication Yes @param id [Integer] The numerical ID of the desired status. @param options [Hash] A customizable set of options. @option options [Boolean, String, Integer] :include_entities Include {dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, ‘t’ or 1. @return [Twitter::Status] The un-favorited status. @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid. @example Un-favorite the status with the ID 25938088801

  Twitter.unfavorite(25938088801)

[Validate]