Method: Twitter::REST::Tweets#update_with_media

Defined in:
lib/twitter/rest/tweets.rb

#update_with_media(status, media, options = {}) ⇒ Twitter::Tweet

Note:

A status update with text/media identical to the authenticating user's current status will NOT be ignored

Updates the authenticating user's status with media

Parameters:

  • status (String) —

    The text of your status update, up to 140 characters.

  • media (File, Hash) —

    A File object with your picture (PNG, JPEG or GIF)

  • options (Hash) (defaults to: {}) —

    A customizable set of options.

Options Hash (options):

  • :possibly_sensitive (Boolean, String, Integer) —

    Set to true for content which may not be suitable for every audience.

  • :in_reply_to_status (Twitter::Tweet) —

    An existing status that the update is in reply to.

  • :in_reply_to_status_id (Integer) —

    The ID of an existing Tweet that the update is in reply to.

  • :lat (Float) —

    The latitude of the location this tweet refers to. This option will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding :long option.

  • :long (Float) —

    The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This option will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding :lat option.

  • :place (Twitter::Place) —

    A place in the world. These can be retrieved from PlacesAndGeo#reverse_geocode.

  • :place_id (String) —

    A place in the world. These IDs can be retrieved from PlacesAndGeo#reverse_geocode.

  • :display_coordinates (String) —

    Whether or not to put a pin on the exact coordinates a tweet has been sent from.

  • :trim_user (Boolean, String, Integer) —

    Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.

Returns:

Raises:

See Also:

Rate Limited?:

  • No

Authentication:

  • Requires user context



228
229
230
231
232
233
234
 
# File 'lib/twitter/rest/tweets.rb', line 228

def update_with_media(status, media, options = {})
  raise(Twitter::Error::UnacceptableIO.new) unless media.respond_to?(:to_io)
  hash = options.dup
  hash[:in_reply_to_status_id] = hash.delete(:in_reply_to_status).id unless hash[:in_reply_to_status].nil?
  hash[:place_id] = hash.delete(:place).woeid unless hash[:place].nil?
  perform_post_with_object('/1.1/statuses/update_with_media.json', hash.merge('media[]' => media, 'status' => status), Twitter::Tweet)
end