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 280 characters.

• media (File, Array<File>) —

  An image file or array of image files (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:

• (Twitter::Tweet) —

  The created Tweet.

Raises:

• (Twitter::Error::Unauthorized) —

  Error raised when supplied user credentials are not valid.

See Also:

• https://dev.twitter.com/rest/reference/post/statuses/update_with_media

Rate Limited?:

• No

Authentication:

• Requires user context

# File 'lib/twitter/rest/tweets.rb', line 224

def update_with_media(status, media, options = {})
  options = options.dup
  media_ids = pmap(array_wrap(media)) do |medium|
    upload(medium)[:media_id]
  end
  update!(status, options.merge(media_ids: media_ids.join(',')))
end