lib/youku/v2/videos.rb in youku_client-0.0.2 vs lib/youku/v2/videos.rb in youku_client-0.0.3

@@ -1,10 +1,72 @@
 module Youku
   module V2
     class Videos < Base
       BASE_URI = "#{BASE_URI}/videos"
 
+      # Public: Get basic information by video ID
+      #
+      # See: http://open.youku.com/docs?id=44
+      #
+      # video_id  - The video ID.
+      # video_url - The video's URL.
+      #
+      # Returns the instance of Youku::V2::Request.
+      def show_basic(video_id: nil, video_url: nil)
+        Youku::V2::Request.new "#{BASE_URI}/show_basic.json", {
+          client_id: client.client_id,
+          video_id:  video_id,
+          video_url: video_url,
+        }
+      end
+
+      # Public: Get basic information by video IDs
+      #
+      # See: http://open.youku.com/docs?id=45
+      #
+      # video_ids - The String video IDs.
+      #
+      # Returns the instance of Youku::V2::Request.
+      def show_basic_batch(video_ids: nil)
+        Youku::V2::Request.new "#{BASE_URI}/show_basic_batch.json", {
+          client_id: client.client_id,
+          video_ids: video_ids,
+        }
+      end
+
+      # Public: Get video by ID
+      #
+      # See: http://open.youku.com/docs?id=46
+      #
+      # video_id - The String video ID.
+      # ext      - The String video extension information.
+      #
+      # Returns the instance of Youku::V2::Request.
+      def show(video_id: nil, ext: nil)
+        Youku::V2::Request.new "#{BASE_URI}/show.json", {
+          client_id: client.client_id,
+          video_id:  video_id,
+          ext:       ext,
+        }
+      end
+
+      # Public: Get videos by IDs
+      #
+      # See: http://open.youku.com/docs?id=47
+      #
+      # video_ids - The comma separated String of video IDs.
+      # ext       - The String video extension information.
+      #
+      # Returns the instance of Youku::V2::Request.
+      def show_batch(video_ids: nil, ext: nil)
+        Youku::V2::Request.new "#{BASE_URI}/show_batch.json", {
+          client_id: client.client_id,
+          video_ids: video_ids,
+          ext:       ext,
+        }
+      end
+
       # Public: Get videos for given Youku user.
       #
       # See: http://open.youku.com/docs?id=49
       #
       # user_id   - The String Youku user ID.
@@ -19,44 +81,84 @@
           client_id: client.client_id,
           user_id:   user_id,
           user_name: user_name,
           orderby:   orderby,
           page:      page,
-          count:     count
+          count:     count,
         }
       end
 
-      # Public: Get video by ID
+      # Public: Get videos that relate to another video.
       #
-      # See: http://open.youku.com/docs?id=46
+      # See: http://open.youku.com/docs?id=52
       #
       # video_id - The String video ID.
-      # ext      - The String video extension information.
+      # count    - The Integer page size.
       #
       # Returns the instance of Youku::V2::Request.
-      def show(video_id, ext: nil)
-        Youku::V2::Request.new "#{BASE_URI}/show.json", {
+      def by_related(video_id: nil, count: 20)
+        Youku::V2::Request.new "#{BASE_URI}/by_related.json", {
           client_id: client.client_id,
           video_id:  video_id,
-          ext:       ext
+          count:     count,
         }
       end
 
-      # Public: Get videos by IDs
+      # Public: Get videos for a given category.
       #
-      # See: http://open.youku.com/docs?id=47
+      # See: http://open.youku.com/docs?id=57
       #
-      # video_ids - The comma separated String of video IDs.
-      # ext       - The String video extension information.
+      # category - The String category.
+      # genre    - The String genre.
+      # period   - The String period.
+      # orderby  - The String order of videos.
+      # page     - The Integer page number.
+      # count    - The Integer page size.
       #
       # Returns the instance of Youku::V2::Request.
-      def show_batch(video_ids: nil, ext: nil)
-        Youku::V2::Request.new "#{BASE_URI}/show_batch.json", {
+      def by_category(category: nil, genre: nil, period: nil, orderby: 'view-count', page: 1, count: 20)
+        Youku::V2::Request.new "#{BASE_URI}/by_category.json", {
           client_id: client.client_id,
-          video_ids: video_ids,
-          ext:       ext
+          category:  category,
+          genre:     genre,
+          period:    period,
+          orderby:   orderby,
+          page:      page,
+          count:     count,
         }
       end
 
+      # Public: Get favourite API.
+      #
+      # Returns the instance of Youku::V2::Videos::Favorite.
+      def favorite
+        Favorite.new(client)
+      end
+
+      class Favorite < Base
+        BASE_URI = "#{BASE_URI}/favorite"
+
+        # Public: Get a given user's favorite videos
+        #
+        # See: http://open.youku.com/docs?id=54
+        #
+        # user_id   - The String Youku user ID.
+        # user_name - The String Youku user name.
+        # orderby   - The String order of videos.
+        # page      - The Integer page number.
+        # count     - The Integer page size.
+        #
+        # Returns the instance of Youku::V2::Request.
+        def by_user(user_id: nil, user_name: nil, orderby: 'favorite-time', page: 1, count: 20)
+          Youku::V2::Request.new "#{BASE_URI}/by_user.json", {
+            client_id: client.client_id,
+            user_id:   user_id,
+            user_name: user_name,
+            orderby:   orderby,
+            page:      page,
+            count:     count,
+          }
+        end
+      end
     end
   end
 end