yam 0.0.6 → 1.0.0

data/lib/yammer.rb

@@ -0,0 +1,47 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+require 'yammer/version'
+require 'yammer/error'
+require 'yammer/configurable'
+require 'yammer/api'
+require 'yammer/http_adapter'
+require 'yammer/client'
+require 'yammer/api_handler'
+require 'yammer/api_response'
+require 'yammer/identity_map'
+require 'yammer/base'
+require 'yammer/user'
+require 'yammer/group'
+require 'yammer/group_membership'
+require 'yammer/message'
+require 'yammer/thread'
+
+module Yammer
+  class << self
+    include Configurable
+    include ApiHandler
+
+    def to_s
+      "<#{self.name}: #{self.options.inspect}>"
+    end
+
+  private
+    def method_missing(method_name, *args, &block)
+      return super unless api_handler.respond_to?(method_name)
+      api_handler.send(method_name, *args, &block)
+    end
+  end
+end
+Yammer.reset!

data/lib/yammer/api.rb

@@ -0,0 +1,29 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+require 'yammer/api/user'
+require 'yammer/api/group'
+require 'yammer/api/group_membership'
+require 'yammer/api/message'
+require 'yammer/api/thread'
+require 'yammer/api/search'
+require 'yammer/api/topic'
+require 'yammer/api/like'
+require 'yammer/api/autocomplete'
+require 'yammer/api/network'
+require 'yammer/api/notification'
+require 'yammer/api/pending_attachment'
+require 'yammer/api/invitation'
+require 'yammer/api/subscription'
+require 'yammer/api/open_graph_object'

data/lib/yammer/api/autocomplete.rb

@@ -0,0 +1,39 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+module Yammer
+  module Api
+    module Autocomplete
+
+      # @see https://developer.yammer.com/restapi/#rest-search
+      # @api_path /api/v1/autocomplete/ranked
+      # @rate_limited Yes
+      # @authentication authenticated user context
+      # @raise [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the options to fetch a thread with
+      # @option opts [String] :prefix
+      # @option opts [String] :models
+      # @option opts [Integer] :network_id
+      # @option opts [Integer] :include_site_actions
+      # @option opts [Boolean] :extended]
+      # @option opts [Boolean] :include_network_domainss
+      # @example Fetch data for the thread
+      #   Yammer.search(:prefix => 'pizza', :models => 'user:3,group:8,topic:10')
+      def autocomplete(opts={})
+        get('/api/v1/autocomplete/ranked', opts)
+      end
+    end
+  end
+end

data/lib/yammer/api/group.rb

@@ -0,0 +1,92 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+module Yammer
+  module Api
+    module Group
+
+      # @see https://developer.yammer.com/restapi/#rest-groups
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the opts to fetch a thread with
+      # @option opts [Integer] :page
+      # @option opts [String] :sort_by sort groups by created_on, creator, name default order is by number of messages
+      # @option opts [String] :letter groups starting with letter
+      # @example Fetch all groups for authenticated user's network
+      #   Yammer.all_groups
+      def all_groups(opts={})
+        get("/api/v1/groups", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-groups
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the group ID
+      # @example Fetch data for specified group
+      #   Yammer.get_group(74)
+      def get_group(id)
+        get("/api/v1/groups/#{id}")
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-groups
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the opts to fetch a thread with
+      # @option opts [String] :name
+      # @option opts [String] :description
+      # @option opts [Boolean] :private
+      # @option opts [Boolean] :show_in_directory
+      # @example Create a new public group
+      #   Yammer.create_group(:name => "new group name", :private => "false")
+      def create_group(opts={})
+        post("/api/v1/groups", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-groups
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the group ID
+      # @param [Hash] opts
+      # @option opts [String] :name
+      # @option opts [String] :description
+      # @option opts [Boolean] :private
+      # @option opts [Boolean] :show_in_directory
+      # @example Update data for a given group
+      #   Yammer.update_group(74, :name => "new group name")
+      def update_group(id, opts={})
+        post("/api/v1/groups/#{id}", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-groups
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the user ID
+      # @example Fetch groups for a given user
+      #   Yammer.groups_for_user(74)
+      def groups_for_user(id)
+        get("/api/v1/groups/for_user/#{id}")
+      end
+    end
+  end 
+end

data/lib/yammer/api/group_membership.rb

@@ -0,0 +1,46 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+module Yammer
+  module Api
+    module GroupMembership
+
+      # @see https://developer.yammer.com/restapi/#rest-group_memberships
+      # @api_path /api/v1/group_memberships/id
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the group membership ID
+      # @example Fetch data for the thread
+      #   Yammer.get_group_membership(7)
+      def get_group_membership(id)
+        get("/api/v1/group_memberships/#{id}")
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-groups
+      # @api_path /api/v1/group_memberships
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the group ID
+      # @example Fetch data for the thread
+      #   Yammer.create_group_membership(74)
+      def create_group_membership(id)
+        post("/api/v1/group_memberships", :group_id => id)
+      end
+    end
+  end 
+end

data/lib/yammer/api/invitation.rb

@@ -0,0 +1,39 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+
+module Yammer
+  module Api
+    module Invitation
+
+      # @see https://developer.yammer.com/restapi/#rest-invitations
+      # @api_path /api/v1/invitations
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [String, Array] email or list of email addresses to send invitations to
+      # @example Fetch data for the thread
+      #
+      #   Yammer.invite(%{ bob@yammer.com alice@yammer.com })
+      #
+      #   Yammer.invite('bob@yammer.com, alice@yammer.com')
+      def invite(email)
+        email = email.strip if email.is_a?(String)
+        email = email.join(',') if email.is_a?(Array)
+        post('/api/v1/invitations', :email => email)
+      end
+    end
+  end
+end

data/lib/yammer/api/like.rb

@@ -0,0 +1,57 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+module Yammer
+  module Api
+    module Like
+
+      # Delivers a ‘like’ action to the activity stream
+      # @see https://developer.yammer.com/
+      # @api_path /api/v1/likes
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Integer] id
+      # @param [String]  type
+      def like(type, id)
+        post('/api/v1/likes', :id => id, :type => type)
+      end
+
+      # Unlike
+      # @see https://developer.yammer.com/
+      # @api_path /api/v1/likes
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Integer] id
+      def unlike(id)
+        delete("/api/v1/likes/#{id}")
+      end
+
+      # Used to determine if current user likes ogo
+      # @see https://developer.yammer.com/
+      # @api_path /api/v1/likes
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Integer] id
+      def likes_open_graph_object?(id)
+        get("/api/v1/likes/open_graph_object/#{id}")
+      end
+    end
+  end
+end

data/lib/yammer/api/message.rb

@@ -0,0 +1,227 @@
+# Copyright (c) Microsoft Corporation
+# All rights reserved.
+# Licensed under the Apache License, Version 2.0 (the "License"); 
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 
+#
+# THIS CODE IS PROVIDED *AS IS* BASIS, WITHOUT WARRANTIES OR 
+# CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING 
+# WITHOUT LIMITATION ANY IMPLIED WARRANTIES OR CONDITIONS OF TITLE,
+# FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABLITY OR NON-INFRINGEMENT. 
+
+# See the Apache Version 2.0 License for specific language governing
+# permissions and limitations under the License.
+
+module Yammer
+  module Api
+    module Message
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param body [String] Message body
+      # @param [Hash] opts the options to create a message with
+      # @option opts [Integer] :cc
+      # @option opts [Integer] :replied_to_id
+      # @option opts [Integer] :group_id 
+      # @option opts [Array<Integer>] :direct_to_user_ids
+      # @option opts [Array<Integer>] :pending_attachment_ids
+      # @example Create a new message
+      #   msg1 = Yammer.create_message('what are you workings on?')
+      #
+      #   msg2 = Yammer.create_message('building a yammer client', :replied_to_id => msg.id)
+      def create_message(body, opts={})
+        opts[:body] = body
+        post("/api/v1/messages", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise [Yammer::Error::BadRequest] Error raised when you try to delete a message that
+      #   you did not create      
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the thread ID
+      # @example Delete an existing message
+      #   result = Yammer.delete_message(1)
+      def delete_message(id)
+        delete("/api/v1/messages/#{id}")
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the ID of the message to be fetched
+      # @example Fetch an existing message
+      #   msg = Yammer.get_message(3)
+      def get_message(id)
+        get("/api/v1/messages/#{id}")
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of messages from the company feed
+      #   msgs = Yammer.all_messages
+      def all_messages(opts={})
+        get("/api/v1/messages", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch list messages sent by authenticated user
+      #   msgs = Yammer.messages_sent
+      def messages_sent(opts={})
+        get("/api/v1/messages/sent", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch list of messages sent to authenitcated user
+      #   msgs = Yammer.messages_received
+      def messages_received(opts={})
+        get("/api/v1/messages/received", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of private messages sent to authenitcated user
+      #   msgs = Yammer.private_messages
+      def private_messages(opts={})
+        get("/api/v1/messages/private", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of messages being followed by authenitcated user
+      #   msgs = Yammer.followed_messages
+      def followed_messages(opts={})
+        get("/api/v1/messages/following", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the ID of the user whose public messages we want to look at
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of messages sent by a user in the authenticated user's network
+      #   msgs = Yammer.messages_from_user(8)
+      def messages_from_user(id, opts={})
+        get("/api/v1/messages/from_user/#{id}", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the topic ID
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch messages that have been tagged with a given topic
+      #   msgs = Yammer.messages_about_topic(1)
+      def messages_about_topic(id, opts={})
+        get("/api/v1/messages/about_topic/#{id}", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the ID of the group whose messages you wish to fetch
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of messages in a given group
+      #   msgs = Yammer.messages_in_group(38)
+      def messages_in_group(id, opts={})
+        get("/api/v1/messages/in_group/#{id}", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the ID of the user for whom you wish to get a list of messages they have liked
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of messages liked by a given user
+      #   msgs = Yammer.messages_liked_by(4)
+      def messages_liked_by(id, opts={})
+        get("/api/v1/messages/liked_by/#{id}", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the thread ID
+      # @param [Hash] opts the options to fetch the messages with
+      # @option opts [Integer] :newer_than
+      # @example Fetch a list of messages in a given thread
+      #   msgs = Yammer.messages_in_thread(10)
+      def messages_in_thread(id, opts={})
+        get("/api/v1/messages/in_thread/#{id}", opts)
+      end
+
+      # @see https://developer.yammer.com/restapi/#rest-messages
+      # @api_path /api/v1/messages/open_graph_objects
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise  [Yammer::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Yammer::ApiResponse]
+      # @param id [Integer] the thread ID
+      # @example Fetch a list of messages in a given thread
+      #   msgs = Yammer.messages_for_open_graph_pbject(10)
+      def messages_for_open_graph_object(id)
+        get("/api/v1/messages/messages/open_graph_objects/#{id}")
+      end
+    end
+  end 
+end