adds autocomplete API

lib/yammer/client/search.rb

@@ -10,14 +10,39 @@ module Search
       # @param query [String] The search query.
       # @param options [Hash] A customizable set of options.
       # @option options [Integer] :page Only 20 results of each type will be returned for each page, but a total count is returned with each query. page=1 (the default) will return items 1-20, page=2 will return items 21-30, etc.
-      # @option options [Integer] :num_per_page limit of search results, up to a maximum of 20, the default value. 
+      # @option options [Integer] :num_per_page limit of search results, up to a maximum of 20, the default value.
       # @return [Hashie::Mash]
       # @see https://developer.yammer.com/api/#search
-      # @example 
+      # @example
       #   Yammer.search("my boss")
       def search(query, options={})
         get('search', options.merge({:search => query}))
       end
+
+      # Returns autocomplete style matches for messages, users, and tags.
+      #
+      # @format `:json`
+      # @authenticated true
+      # @rate_limited 20/min - make sure you implement caching in your app!!!
+      # @param search [String] The search query.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Symbol] :type restricts search results to a particular type of object: :users, :tags, or :users_groups
+      # @return [Hashie::Mash]
+      # @see https://developer.yammer.com/restapi/#rest-autocomplete
+      # @example
+      #   Yammer.autocomplete("bill", :type => :user)
+      def autocomplete(search, options={:type => :users})
+        prefix = case options[:type]
+        when :users || :user
+          "@" + search
+        when :tags || :tag
+          "#" + search
+        when :users_groups
+          "to:" + search
+        end
+
+        get('autocomplete', options.merge({:prefix => prefix}))
+      end
     end
   end
 end