douban_api 0.1.0

data/lib/douban_api/client/discussion.rb

@@ -0,0 +1,44 @@
+module Douban
+  class Client
+    # 论坛API V2 http://developers.douban.com/wiki/?title=discussion_v2
+    module Discussion
+      def discussion(id)
+        get "v2/discussion/#{id}"
+      end
+      
+      def update_discussion(id, options={})
+        put "v2/discussion/#{id}", options
+      end
+      
+      def delete_discussion(id)
+        delete "v2/discussion/#{id}"
+      end
+      
+      def create_discussion(id ,options={})
+        post "v2/target/#{id}/discussions", options
+      end
+      
+      def discussions(id, options={})
+        response = get("v2/target/#{id}/discussions", options)
+        response["discussions"]
+      end
+      
+      def discussion_comments(id, options={})
+        comments('discussion', id, options={})
+      end
+
+      def create_discussion_comment(id, content)
+        create_comment('discussion', id, content)
+      end
+
+      def discussion_comment(discussion_id, comment_id)
+        comment('discussion', discussion_id, comment_id)
+      end
+
+      def remove_discussion_comment(discussion_id, comment_id)
+        remove_comment('discussion', discussion_id, comment_id)
+      end
+
+    end
+  end
+end

data/lib/douban_api/client/doumail.rb

@@ -0,0 +1,120 @@
+module Douban
+  class Client
+    # 豆邮Api V2 http://developers.douban.com/wiki/?title=doumail_v2
+    module Doumail
+      # 获取一封邮件
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#get_mail
+      # @scope community_advanced_doumail_r
+      # @authenticated true
+      # @param id [String] 豆邮的id
+      # @return [Hashie::Mash] 豆邮信息
+      # @example 获取 id为281922967 的豆邮
+      #   client.doumail('281922967')
+      def doumail(id, keep_unread=false)
+        response = get("v2/doumail/#{id}", :"keep-unread" => keep_unread)
+      end
+
+      # 获取用户收件箱
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#inbox
+      # @scope community_advanced_doumail_r
+      # @authenticated true
+      # @return [Array<Hashie::Mash>] 豆邮列表
+      # @example 获取当前用户的收件箱
+      #   client.inbox
+      def inbox(options={})
+        response = get "v2/doumail/inbox"
+        response["mails"]
+      end
+
+      # 获取用户发件箱
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#outbox
+      # @scope community_advanced_doumail_r
+      # @authenticated true
+      # @return [Array<Hashie::Mash>] 豆邮列表
+      # @example 获取当前用户的发件箱
+      #   client.outbox
+      def outbox(options={})
+        response = get "v2/doumail/outbox"
+        response["mails"]
+      end
+
+      # 获取用户未读邮件
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#unread
+      # @scope community_advanced_doumail_r
+      # @authenticated true
+      # @return [Array<Hashie::Mash>] 豆邮列表
+      # @example 获取当前用户未读邮件
+      #   client.unread
+      def unread(options={})
+        response = get "v2/doumail/inbox/unread"
+        response["mails"]
+      end
+
+      # 标记已读邮件
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#read
+      # @scope community_advanced_doumail_w
+      # @authenticated true
+      # @param id [String] 豆邮的id
+      # @param id [Array<String>] 豆邮id的列表
+      # @return [Hashie::Mash] 豆邮信息
+      # @example 标记id为281740901的
+      #   client.read("281740901")
+      # @example 标记多个豆邮为已读
+      #   client.read(["281740901", "281745597"])
+      def read(id)
+        if id.is_a?(Array)
+          response = put("v2/doumail/read", :ids => id.join(','))
+          response["doumails"]
+        else 
+          put "v2/doumail/#{id}"
+        end
+      end
+
+      # 删除豆邮
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#delete
+      # @scope community_advanced_doumail_w
+      # @authenticated true
+      # @param id [String] 豆邮的id
+      # @param id [Array<String>] 豆邮id的列表
+      # @return [Hashie::Mash] 豆邮信息
+      # @example 删除id为281740901的删除
+      #   client.delete_doumail("281740901")
+      # @example 删除多个豆邮
+      #   client.delete_doumail(["281740901", "281745597"])
+      def delete_doumail(id)
+        if id.kind_of?(Array)
+          post "v2/doumail/delete", :ids => id.join(',')
+        else
+          post "v2/doumail/#{id}"
+        end
+      end
+      
+      # 发送一封豆邮
+      #
+      # @see http://developers.douban.com/wiki/?title=doumail_v2#send
+      # @scope community_advanced_doumail_w
+      # @authenticated true
+      # @param receiver_id [String] 收件人的id
+      # @option options [String] :title 豆邮标题:  必填字段
+      # @option options [String] :content 豆邮正文: 必填字段
+      # @option options [String] :captcha_token 系统验证码 token: 选填字段
+      # @option options [String] :captcha_string 用户输入验证码: 选填字段
+      # @return [Hashie::Mash] 豆邮信息
+      # @example 发送一封豆邮
+        # client.send_doumail('48576635', {
+        #   :title => "test",
+        #   :content => "只是test"
+        # })
+      def send_doumail(receiver_id, options={})
+        options["receiver_id"] = receiver_id
+        post("v2/doumails", options) == {}
+      end
+    end
+  end
+end

data/lib/douban_api/client/event.rb

@@ -0,0 +1,209 @@
+module Douban
+  class Client
+    # 豆瓣同城 V2 http://developers.douban.com/wiki/?title=event_v2
+    module Event
+
+      # 获取活动
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_get
+      # @scope event_basic_r
+      # @authenticated false
+      # @param id [String] 活动的id
+      # @return [Hashie::Mash] 活动信息
+      # @example 获取 id为17790089 的活动信息
+      #   Douban.event('17790089')
+      def event(id)
+        response = get "v2/event/#{id}"
+      end
+
+      # 获取参加活动的用户
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_participants
+      # @scope event_basic_r
+      # @authenticated false
+      # @param id [String] 活动的id
+      # @return [Array<Hashie::Mash>] 用户列表
+      # @example 获取参与 id为17790089 活动的用户
+      #   Douban.event_participants('17790089')
+      def event_participants(id)
+        response = get "v2/event/#{id}/participants"
+        response["users"]
+      end
+
+      # 获取活动感兴趣的用户
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_wishers
+      # @scope event_basic_r
+      # @authenticated false
+      # @param id [String] 活动的id
+      # @return [Array<Hashie::Mash>] 用户列表
+      # @example 获取对 id为17790089 活动感兴趣的用户
+      #   Douban.event_wishers('17790089')
+      def event_wishers(id)
+        response = get "v2/event/#{id}/wishers"
+        response["users"]
+      end
+
+      # 获取用户创建的活动
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_user_created
+      # @scope event_basic_r
+      # @authenticated false
+      # @param user_id [String] 用户的数字id
+      # @return [Array<Hashie::Mash>] 活动列表
+      # @example 获取 id为2217855 的用户创建的活动
+      #   Douban.created_events('2217855')
+      # @example 获取已认证的用户创建的活动
+      #   client.created_events()
+      def created_events(user_id=nil, options={})
+        if user_id.nil?
+          response = get("v2/event/user_created/#{get_user_id}", options)
+        else
+          response = get("v2/event/user_created/#{user_id}", options)
+        end
+        
+        response["events"]
+      end
+
+      # 获取用户参加的活动
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_user_participated
+      # @scope event_basic_r
+      # @authenticated false
+      # @param user_id [String] 用户的数字id
+      # @return [Array<Hashie::Mash>] 活动列表
+      # @example 获取 id为2217855 的用户参加的活动
+      #   Douban.participated_events('2217855')
+      # @example 获取已认证的用户参加的活动
+      #   client.participated_events()
+      def participated_events(user_id=nil)
+        if user_id.nil?
+          response = get "v2/event/user_participated/#{get_user_id}"
+        else
+          response = get "v2/event/user_participated/#{user_id}"
+        end
+        
+        response["events"]
+      end
+
+      # 获取用户参加的活动
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_user_wished
+      # @scope event_basic_r
+      # @authenticated false
+      # @param user_id [String] 用户的数字id
+      # @return [Array<Hashie::Mash>] 活动列表
+      # @example 获取 id为2217855 的用户感兴趣的活动
+      #   Douban.wished_events('2217855')
+      # @example 获取已认证的用户感兴趣的活动
+      #   client.wished_events()
+      def wished_events(user_id=nil)
+        if user_id.nil?
+          response = get "v2/event/user_wished/#{get_user_id}"
+        else
+          response = get "v2/event/user_wished/#{user_id}"
+        end
+        
+        response["events"]
+      end
+
+      # 获取活动列表
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_list
+      # @scope event_basic_r
+      # @authenticated false
+      # @param loc_id [String] 城市id
+      # @option options [String] :day_type 
+      #   时间类型: future, week, weekend, today, tomorrow
+      # @option options [String] :type
+      #   活动类型: all,music, film, drama, commonweal, salon, exhibition, party, sports, travel, others
+      # @return [Array<Hashie::Mash>] 活动列表
+      # @example 查看北京地区的音乐活动
+      #   Douban.events('108288', :type => "music")
+      def events(loc_id, options={})
+        response = get("v2/event/list", options.merge(:loc => loc_id))
+        response["events"]
+      end
+
+      # 获取城市
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#loc_get
+      # @scope event_basic_r
+      # @authenticated false
+      # @param loc_id [String] 城市id
+      # @return [Hashie::Mash] 活动列表
+      # @example 查看北京的信息
+      #   Douban.loc('108288')
+      def loc(id)
+        response = get "v2/loc/#{id}"
+      end
+
+      # 获取城市列表
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#loc_list
+      # @scope event_basic_r
+      # @authenticated false
+      # @return [Array<Hashie::Mash>] 城市列表
+      # @example 城市列表
+      #   Douban.loc_list
+      def loc_list(options={})
+        response = get("v2/loc/list", options)
+        response["locs"]
+      end
+
+      # 参加活动
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_participate
+      # @scope event_basic_w
+      # @authenticated true
+      # @param id [String] 活动的id
+      # @option options [String] :participate_date
+      #   参加时间: 时间格式：“％Y-％m-％d”，无此参数则时间待定
+      # @return [Hashie::Mash] 活动信息
+      # @example 参加 id为17717231 的活动
+      #   client.participants_event('17717231')
+      def participants_event(id, options={})
+        post "v2/event/#{id}/participants", options
+      end
+
+      # 不参加活动
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_quit
+      # @scope event_basic_w
+      # @authenticated true
+      # @param id [String] 活动的id
+      # @return [Hashie::Mash] 活动信息
+      # @example 取消参加 id为17717231 的活动
+      #   client.unparticipants_event('17717231')
+      def unparticipants_event(id)
+        delete "v2/event/#{id}/participants"
+      end
+      
+      # 对活动感兴趣
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_wish
+      # @scope event_basic_w
+      # @authenticated true
+      # @param id [String] 活动的id
+      # @return [Hashie::Mash] 活动信息
+      # @example 对 id为17717231 的活动感兴趣
+      #   client.wish_event('17717231')
+      def wish_event(id)
+        post "v2/event/#{id}/wishers"
+      end
+
+      # 对活动不感兴趣
+      #
+      # @see http://developers.douban.com/wiki/?title=event_v2#event_unwish
+      # @scope event_basic_w
+      # @authenticated true
+      # @param id [String] 活动的id
+      # @return [Hashie::Mash] 活动信息
+      # @example 对 id为17717231 的活动不感兴趣
+      #   client.wish_event('17717231')
+      def unwish_event(id)
+        delete "v2/event/#{id}/wishers"
+      end
+    end
+  end
+end

data/lib/douban_api/client/movie.rb

@@ -0,0 +1,157 @@
+module Douban
+  class Client
+    # 电影Api V2 http://developers.douban.com/wiki/?title=movie_v2
+    module Movie
+      # 获取电影信息
+      #
+      # @see http://developers.douban.com/wiki/?title=movie_v2#get_movie
+      # @scope movie_basic_r
+      # @authenticated false
+      # @param id [String] 电影的id
+      # @return [Hashie::Mash] 电影信息
+      # @example 获取 id为1296987 的电影信息
+      #   Douban.movie('1296987')
+      def movie(id)
+        response = get "v2/movie/#{id}"
+      end
+
+      # 根据imdb号获取电影信息
+      #
+      # @scope movie_basic_r
+      # @see http://developers.douban.com/wiki/?title=movie_v2#get_imdb_movie
+      # @authenticated false
+      # @param id [String] IMDb编号
+      # @return [Hashie::Mash] 电影信息
+      # @example 获取 IMDb编号为tt0075686 的图书信息
+      #   Douban.imdb('tt0075686')
+      def imdb(id)
+        response = get "v2/movie/imdb/#{id}"
+      end
+
+      # 某个电影中标记最多的标签
+      #
+      # @scope movie_basic_r
+      # @see http://developers.douban.com/wiki/?title=movie_v2#get_movie_tags
+      # @authenticated false
+      # @param id [String] 电影的id
+      # @return [Array<Hashie::Mash>] 标签列表
+      # @example 获取 电影id为1296987 的标签
+      #   Douban.movie_tags('1296987')
+      def movie_tags(id, optins={})
+        response = get "v2/movie/#{id}/tags", options
+        responses["tags"]
+      end
+
+      # 搜索电影
+      #
+      # @scope movie_basic_r
+      # @see http://developers.douban.com/wiki/?title=movie_v2#get_movie_search
+      # @authenticated false
+      # @param q [String] 查询关键字
+      # @return [Hashie::Mash] 电影列表
+      # @example 搜索电影 伍迪·艾伦 相关的电影
+      #   Douban.search_movies("伍迪·艾伦")
+      def search_movies(q, options={})
+        response = get "v2/movie/search", options.merge(:q => q)
+        response["movies"]
+      end
+
+      # 搜索电影(通过标签)
+      #
+      # @scope movie_basic_r
+      # @see http://developers.douban.com/wiki/?title=movie_v2#get_movie_search
+      # @authenticated false
+      # @param tag [String] 查询的tag
+      # @return [Hashie::Mash] 电影列表
+      # @example 搜索含有标签 悬疑 的电影
+      #   Douban.search_movies_by_tag("悬疑")
+      def search_movies_by_tag(tag, options={})
+        response = get "v2/movie/search", options.merge(:tag => tag)
+        response["movies"]
+      end
+
+      # 发表新评论
+      #
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=movie_v2#post_movie_review
+      # @authenticated true
+      # @param id [String] 电影的id
+      # @option options [String] :title 必传
+      # @option options [String] :content 必传，且多于150字
+      # @option options [Integer] :rating 非必传，数字1～5为合法值，其他信息默认为不打分     
+      # @return [Hashie::Mash] 电影评论信息
+      # @example 给 id为1296987 的电影添加评论
+      #   client.create_movie_review("1296987", {
+      #     :title  => "我们都需要鸡蛋",
+      #     :content => "哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈
+      #      哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈
+      #      哈哈哈哈哈哈哈哈哈哈哈哈...(省略一些哈)",
+      #     :rating => 5
+      #   })
+      def create_movie_review(id, options={})
+        post "v2/movie/reviews", options
+      end
+
+      # 修改评论
+      #
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=movie_v2#put_movie_review
+      # @authenticated true
+      # @param id [String] 评论的id
+      # @option options [String] :title 必传
+      # @option options [String] :content 必传，且多于150字
+      # @option options [Integer] :rating 非必传，数字1～5为合法值，其他信息默认为不打分     
+      # @return [Hashie::Mash] 电影评论信息
+      # @example 修改id为1406334的评论
+      #   client.edit_movie_review("1406334", {
+      #     :title  => "我们读故事，看电影，不过是因为我们懦弱",
+      #     :content => "嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻
+      #      嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻
+      #      嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻嘻...(省略一些嘻)",
+      #     :rating => 5
+      #   })
+      def edit_movie_review(id, options={})
+        put "v2/movie/reviews/#{id}", options
+      end
+
+      # 删除评论
+      #
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=movie_v2#delete_movie_review
+      # @authenticated true
+      # @param id [String] 电影的id
+      # @return [Boolean] 删除成功则返回true, 否则false
+      # @example 删除 id为1406334 电影评论
+      #   client.remove_movie_review('1406334')
+      def remove_movie_review(id)
+        begin
+          delete "v2/movie/review/#{id}"
+          return true
+        rescue Douban::NotFound
+          return false
+        end
+      end
+
+      # 用户对电影的所有标签
+      # 
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=movie_v2#get_people_movie_tags
+      # @authenticated false
+      # @param user_id [String] 用户的数字id
+      # @return [Array<Hashie::Mash>] 标签列表
+      # @example 获取数字id为2217855的用户电影收藏的所有标签
+      #   Douban.user_movie_tags('2217855')      
+      # @example 获取已认证用户的图书收藏的所有标签
+      #   client.user_movie_tags
+      def user_movie_tags(user_id=nil, options={})
+        if user_id.nil?
+          response = get("v2/movie/user_tags/#{get_user_id}", options)
+        else
+          response = get("v2/movie/user_tags/#{user_id}", options)
+        end
+        
+        response["tags"]
+      end
+    end
+  end
+end

data/lib/douban_api/client/music.rb

@@ -0,0 +1,144 @@
+module Douban
+  class Client
+    # 音乐Api V2 http://developers.douban.com/wiki/?title=music_v2
+    module Music
+      # 获取音乐信息
+      #
+      # @see http://developers.douban.com/wiki/?title=music_v2#get_music
+      # @scope music_basic_r
+      # @authenticated false
+      # @param id [String] 音乐的id
+      # @return [Hashie::Mash] 音乐信息
+      # @example 获取 id为2243497 的音乐信息
+      #   Douban.music('2243497')
+      def music(id)
+        response = get "v2/music/#{id}"
+      end
+
+      # 某个音乐中标记最多的标签
+      #
+      # @scope music_basic_r
+      # @see http://developers.douban.com/wiki/?title=music_v2#get_music_tags
+      # @authenticated false
+      # @param id [String] 音乐的id
+      # @return [Array<Hashie::Mash>] 标签的列表
+      # @example 获取 id为2243497 的音乐的标记最多的标签
+      #   Douban.music_tags("2243497")
+      def music_tags(id, optins={})
+        response = get "v2/music/#{id}/tags", options
+        responses["tags"]
+      end
+
+      # 搜索音乐
+      #
+      # @scope music_basic_r
+      # @see http://developers.douban.com/wiki/?title=music_v2#get_music_search
+      # @authenticated false
+      # @param q [String] 查询关键字
+      # @return [Hashie::Mash] 音乐列表
+      # @example 搜索音乐 LCD soundsystem 相关的音乐
+      #   Douban.search_musics("LCD soundsystem")
+      def search_music(q, options={})
+        response = get "v2/music/search", options.merge(:q => q)
+        response["musics"]
+      end
+      
+      # 搜索音乐(通过标签)
+      #
+      # @scope music_basic_r
+      # @see http://developers.douban.com/wiki/?title=music_v2#get_music_search
+      # @authenticated false
+      # @param tag [String] 查询的tag
+      # @return [Hashie::Mash] 音乐列表
+      # @example 搜索含有标签 post_punk 的音乐
+      #   Douban.search_music_by_tag("post_punk")
+      def search_music_by_tag(tag, options={})
+        response = get "v2/music/search", options.merge(:tag => tag)
+        response["musics"]
+      end
+
+      # 发表新评论
+      #
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=music_v2#post_music_review
+      # @authenticated true
+      # @param id [String] 音乐的id
+      # @option options [String] :title 必传
+      # @option options [String] :content 必传，且多于150字
+      # @option options [Integer] :rating 非必传，数字1～5为合法值，其他信息默认为不打分     
+      # @return [Hashie::Mash] 音乐评论信息
+      # @example 给 id为2243497 的音乐添加评论
+      #   client.create_music_review("2243497", {
+      #     :title  => "用中枢神经在工地现场弹出印记",
+      #     :content => "哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈
+      #      哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈
+      #      哈哈哈哈哈哈哈哈哈哈哈哈...(省略一些哈)",
+      #     :rating => 5
+      #   })
+      def create_music_review(id, options={})
+        post "v2/music/reviews", options
+      end
+
+      # 修改评论
+      #
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=music_v2#put_music_review
+      # @authenticated true
+      # @param id [String] 评论的id
+      # @option options [String] :title 必传
+      # @option options [String] :content 必传，且多于150字
+      # @option options [Integer] :rating 非必传，数字1～5为合法值，其他信息默认为不打分     
+      # @return [Hashie::Mash] 音乐评论信息
+      # @example 修改 id为1206396 的评论
+      #   client.edit_music_review("1206396", {
+      #     :title  => "用中枢神经在工地现场弹出印记",
+      #     :content => "嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿
+      #      嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿
+      #      嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿嘿...(省略一些嘿)",
+      #     :rating => 5
+      #   })
+      def edit_music_review(id, options={})
+        put "v2/music/reviews/#{id}", options
+      end
+
+      # 删除评论
+      #
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=music_v2#delete_music_review
+      # @authenticated true
+      # @param id [String] 音乐的id
+      # @return [Boolean] 删除成功则返回true, 否则false
+      # @example 删除 id为2243497 电影评论
+      #   client.remove_music_review('2243497')
+      def remove_music_review(id)
+        begin
+          delete "v2/music/review/#{id}"
+          return true
+        rescue Douban::NotFound
+          return false
+        end
+      end
+
+      
+      # 用户对音乐的所有标签
+      # 
+      # @scope douban_basic_common
+      # @see http://developers.douban.com/wiki/?title=music_v2#get_people_music_tags
+      # @authenticated false
+      # @param user_id [String] 用户的数字id
+      # @return [Array<Hashie::Mash>] 标签列表
+      # @example 获取数字id为2217855的用户电影收藏的所有标签
+      #   Douban.user_music_tags('2217855')      
+      # @example 获取已认证用户的图书收藏的所有标签
+      #   client.user_music_tags
+      def user_music_tags(user_id=nil, options={})
+        if user_id.nil?
+          response = get("v2/music/user_tags/#{get_user_id}", options)
+        else
+          response = get("v2/music/user_tags/#{user_id}", options)
+        end
+        response["tags"]
+      end
+    end
+  end
+end