Module | Twitter::Client::DirectMessages |
In: |
lib/twitter/client/direct_messages.rb
|
Defines methods related to direct messages
Sends a new direct message to the specified user from the authenticating user
@see dev.twitter.com/docs/api/1/post/direct_messages/new @rate_limited No @requires_authentication Yes @response_format `json` @response_format `xml` @param user [Integer, String] A Twitter user ID or screen name. @param text [String] The text of your direct message, up to 140 characters. @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 [Hashie::Mash] The sent message. @example Send a direct message to @sferik from the authenticating user
Twitter.direct_message_create("sferik", "I'm sending you this message via the Twitter Ruby Gem!") Twitter.direct_message_create(7505382, "I'm sending you this message via the Twitter Ruby Gem!") # Same as above
Destroys a direct message
@see dev.twitter.com/docs/api/1/post/direct_messages/destroy/:id @note The authenticating user must be the recipient of the specified direct message. @rate_limited No @requires_authentication Yes @response_format `json` @response_format `xml` @param id [Integer] The ID of the direct message to delete. @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 [Hashie::Mash] The deleted message. @example Destroys the direct message with the ID 1825785544
Twitter.direct_message_destroy(1825785544)
Returns the 20 most recent direct messages sent to the authenticating user
@see dev.twitter.com/docs/api/1/get/direct_messages @rate_limited Yes @requires_authentication Yes @response_format `json` @response_format `xml` @param options [Hash] A customizable set of options. @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID. @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200. @option options [Integer] :page Specifies the page of results to retrieve. @option options [Boolean, String, Integer] :include_entities Include {dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, ‘t’ or 1. @return [Array] Direct messages sent to the authenticating user. @example Return the 20 most recent direct messages sent to the authenticating user
Twitter.direct_messages
Returns the 20 most recent direct messages sent by the authenticating user
@see dev.twitter.com/docs/api/1/get/direct_messages/sent @rate_limited Yes @requires_authentication Yes @response_format `json` @response_format `xml` @param options [Hash] A customizable set of options. @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID. @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200. @option options [Integer] :page Specifies the page of results to retrieve. @option options [Boolean, String, Integer] :include_entities Include {dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, ‘t’ or 1. @return [Array] Direct messages sent by the authenticating user. @example Return the 20 most recent direct messages sent by the authenticating user
Twitter.direct_messages_sent