myspaceid-sdk 0.1.8

data/README

@@ -0,0 +1,30 @@
+MySpaceID lets your users log on using their MySpace account info,
+after which their MySpaceID data becomes available; that is, your web
+servers will be able to communicate with our web servers and request
+user data.
+
+This SDK project contains examples of the base API code necessary to
+make signed requests against the MySpaceID REST API.
+
+To use the MySpaceID API, you first need to register on the MySpace
+Developer Site, create an app, and obtain a consumer key and
+secret. Information about these procedures, and about MySpaceID in
+general, is available at the MySpaceID Developer Wiki:
+
+http://wiki.developer.myspace.com/index.php?title=Category:MySpaceID
+
+The MySpaceID Ruby SDK enables you to work with MySpace data using the
+OpenStack (OpenID, OAuth etc) and the MySpace REST APIs via
+easy-to-use high level interfaces.
+
+The best way to implement your own application is to take an existing
+sample and customize it.  Working Examples in this SDK:
+
+    * OAuth - make signed requests
+    * OpenID + OAuth Hybrid - delegated login, and making signed requests 
+
+Documentation
+
+    * Ruby SDK Documentation Summary: samples/rails/README
+    * Ruby SDK - API Documentation: http://myspaceid-ruby-sdk.googlecode.com/svn/trunk/doc/index.html
+

data/lib/myspace.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'oauth/consumer'
+require 'openid/consumer'
+require 'json'
+require 'logger'
+
+require 'patches'
+
+module MySpace
+end
+
+require 'myspace/myspace'
+require 'myspace/exceptions'
+require 'myspace/oauth'
+

data/lib/myspace/exceptions.rb

@@ -0,0 +1,31 @@
+module MySpace
+  class MySpaceException < Exception
+  end
+
+  class BadIdentifier < MySpaceException
+    attr_reader :parameter, :identifier
+    def initialize(parameter, identifier)
+      @parameter = parameter
+      @identifier = identifier
+    end
+  end
+
+  class RestException < MySpaceException
+    attr_reader :code, :message, :url
+    def initialize(code, message, url)
+      @code = code
+      @message = message
+      @url = url
+    end
+
+    def to_s
+      "#<MySpace::RestException: #{@code}: '#{@message}' loading '#{@url}'>"
+    end
+  end
+
+  class PermissionDenied < RestException
+    def to_s
+      "#<PermissionDenied loading '#{url}'>"
+    end
+  end
+end

data/lib/myspace/myspace.rb

@@ -0,0 +1,565 @@
+module MySpace
+  # The MySpace API object provides access to the MySpace REST API.
+  class MySpace
+    APPLICATION_TYPE_ONSITE     = 'onsite'      unless const_defined?('APPLICATION_TYPE_ONSITE')
+    APPLICATION_TYPE_OFFSITE    = 'offsite'     unless const_defined?('APPLICATION_TYPE_OFFSITE')
+
+    OAUTH_SITES = {
+      :prod => 'http://api.myspace.com',
+      :stage => 'http://stage-api.myspace.com'
+    } unless const_defined?('OAUTH_SITE')
+    
+    OAUTH_REQUEST_TOKEN_URL = '/request_token'  unless const_defined?('OAUTH_REQUEST_TOKEN_URL')
+    OAUTH_AUTHORIZATION_URL = '/authorize'      unless const_defined?('OAUTH_AUTHORIZATION_URL')
+    OAUTH_ACCESS_TOKEN_URL  = '/access_token'   unless const_defined?('OAUTH_ACCESS_TOKEN_URL')
+
+    API_USERINFO_URL   			= '/v1/user.json'                        unless const_defined?('API_USERINFO_URL')
+    API_ALBUMS_URL     			= '/v1/users/%s/albums.json'             unless const_defined?('API_ALBUMS_URL')
+    API_ALBUM_URL      			= '/v1/users/%s/albums/%s/photos.json'   unless const_defined?('API_ALBUM_URL')
+    API_FRIENDS_URL    			= '/v1/users/%s/friends.json'            unless const_defined?('API_FRIENDS_URL')
+    API_FRIENDSHIP_URL 			= '/v1/users/%s/friends/%s.json'         unless const_defined?('API_FRIENDSHIP_URL')
+    API_MOOD_URL       			= '/v1/users/%s/mood.json'               unless const_defined?('API_MOOD_URL')
+    API_PHOTOS_URL     			= '/v1/users/%s/photos.json'             unless const_defined?('API_PHOTOS_URL')
+    API_PHOTO_URL      			= '/v1/users/%s/photos/%s.json'          unless const_defined?('API_PHOTO_URL')
+    API_PROFILE_URL    			= '/v1/users/%s/profile.json'            unless const_defined?('API_PROFILE_URL')
+    API_STATUS_URL     			= '/v1/users/%s/status.json'             unless const_defined?('API_STATUS_URL')
+    API_STATUS_PUT_URL 			= '/v1/users/%s/status'                  unless const_defined?('API_STATUS_PUT_URL')
+    API_VIDEOS_URL     			= '/v1/users/%s/videos.json'             unless const_defined?('API_VIDEOS_URL')
+    API_VIDEO_URL      			= '/v1/users/%s/videos/%s.json'          unless const_defined?('API_VIDEO_URL')
+    API_ACTIVITIES_URL          = '/v1/users/%s/activities.atom'         unless const_defined?('API_ACTIVITIES_URL')
+    API_FRIENDS_ACTIVITIES_URL  = '/v1/users/%s/friends/activities.atom' unless const_defined?('API_FRIENDS_ACTIVITIES_URL')
+
+    attr_reader :consumer
+    attr_accessor :http_logger
+    attr_accessor :request_token
+    attr_accessor :access_token
+
+    # Save the application key/secret(s) and initialize OAuth code.
+    #
+    # If optional param +:application_type+ is passed, it must be one
+    # of +MySpace::APPLICATION_TYPE_ONSITE+ or
+    # +MySpace::APPLICATION_TYPE_OFFSITE+.  If the application is an
+    # onsite application, an access token is not required, since the
+    # user must separately give your application permission to access
+    # their data.  If the application is an offsite application, it
+    # must get an access token from the user to access their data.
+    #
+    # If optional param +:request_token+ is passed
+    # +:request_token_secret+ must also be passed, and they will be
+    # used to create the default argument to
+    # +MySpace#get_access_token+ below.  If optional param
+    # +:access_token+ is passed, +:access_token_secret+ must also be
+    # passed, and they will be used to create the access token for the
+    # REST API calls.
+    #
+    # If optional param +:site+ is passed, it must be either +:prod+
+    # or +:stage+, and MySpace OAuth calls will be directed to either
+    # the production or stage API server accordingly.
+    def initialize(oauth_token_key, oauth_token_secret, params = {})
+      @http_logger = params[:logger]
+      site = params[:site] || :prod
+      @consumer = ::OAuth::Consumer.new(oauth_token_key,
+                                        oauth_token_secret,
+                                        :scheme => :query_string,
+                                        :http_method => :get,
+                                        :site => OAUTH_SITES[site],
+                                        :request_token_path => OAUTH_REQUEST_TOKEN_URL,
+                                        :access_token_path => OAUTH_ACCESS_TOKEN_URL,
+                                        :authorize_path => OAUTH_AUTHORIZATION_URL)
+
+      if params[:application_type] == APPLICATION_TYPE_ONSITE
+        @access_token = ::OAuth::AccessToken.new(@consumer, "", "")
+      elsif params[:access_token]
+        @access_token = ::OAuth::AccessToken.new(@consumer,
+                                                 params[:access_token],
+                                                 params[:access_token_secret])
+      end
+      if params[:request_token]
+        @request_token = ::OAuth::RequestToken.new(@consumer,
+                                                   params[:request_token],
+                                                   params[:request_token_secret])
+      end
+    end
+
+    # Get an unauthorized request token from MySpace.
+    def get_request_token
+      @consumer.get_request_token
+    end
+
+    # Get the url to which to redirect the user in order to authorize
+    # our access to their account.  This url will redirect back to
+    # +callback_url+ once the user authorizes us.
+    def get_authorization_url(request_token, callback_url)
+      "#{request_token.authorize_url}&oauth_callback=#{CGI::escape(callback_url)}"
+    end
+
+    # Get an access token once the user has authorized us.
+    def get_access_token(request_token = @request_token)
+      # response = @consumer.token_request(@consumer.http_method,
+      #                                    (@consumer.access_token_url? ? @consumer.access_token_url : @consumer.access_token_path),
+      #                                    request_token,
+      #                                    {},
+      #                                    headers)
+
+      # @access_token = ::OAuth::AccessToken.new(@consumer, response[:oauth_token], response[:oauth_token_secret])
+      @access_token = request_token.get_access_token
+    end
+
+    # Get the user id of the currently logged in user.
+    def get_userid()
+      user_info = call_myspace_api_json(API_USERINFO_URL)
+      user_info['userId'].to_s
+    end
+
+    # Get the photo album descriptions for the user +user_id+:
+    #
+    # 	{"albums"=>
+    # 	  [{"photosUri"=>
+    # 	     "http://api.myspace.com/v1/users/456073223/albums/40418/photos",
+    # 	     "photoCount"=>1,
+    # 	     "location"=>"",
+    # 	     "title"=>"My Photos",
+    # 	     "id"=>40418,
+    # 	     "defaultImage"=>
+    # 	     "http://c1.ac-images.myspacecdn.com/images02/45/m_f820313641924f0f90004932c8bc310c.jpg",
+    # 	     "privacy"=>"Everyone",
+    # 	     "user"=>
+    # 	     {"name"=>"Bob",
+    # 	       "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	       "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	       "largeImage"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	       "userType"=>"RegularUser",
+    # 	       "userId"=>456073223,
+    # 	       "image"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"},
+    # 	     "albumUri"=>"http://api.myspace.com/v1/users/456073223/albums/40418"}],
+    # 	  "count"=>1,
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_albums(user_id, params = {})
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_ALBUMS_URL, user_id)
+      call_myspace_api_json(url, :get, params)
+    end
+
+    # Get the photo descriptions for the photos of album +album_id+
+    # for the user +user_id+:
+    #
+    # 	{"photos"=>
+    # 	  [{"smallImageUri"=>
+    # 	     "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg",
+    # 	     "photoUri"=>
+    # 	     "http://api.myspace.com/v1/users/456073223/albums/40418/photos/100809",
+    # 	     "id"=>100809,
+    # 	     "uploadDate"=>"2/27/2009 10:14:12 AM",
+    # 	     "caption"=>"",
+    # 	     "lastUpdatedDate"=>"",
+    # 	     "imageUri"=>
+    # 	     "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	     "user"=>
+    # 	     {"name"=>"Bob",
+    # 	       "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	       "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	       "largeImage"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	       "userType"=>"RegularUser",
+    # 	       "userId"=>456073223,
+    # 	       "image"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}],
+    # 	  "count"=>1,
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_album(user_id, album_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      album_id = album_id.to_s
+      validate_identifier(:album_id, album_id)
+      url = sprintf(API_ALBUM_URL, user_id, album_id)
+      call_myspace_api_json(url)
+    end
+
+    # Gets the list of friends for the user +user_id+:
+    #
+    # 	{"topFriends"=>"http://api.myspace.com/v1/users/456073223/friends?list=top",
+    # 	  "Friends"=>
+    # 	  [{"name"=>"Tom",
+    # 	     "uri"=>"http://api.myspace.com/v1/users/6221",
+    # 	     "webUri"=>"http://www.myspace.com/tom",
+    # 	     "largeImage"=>"http://b2.ac-images.myspacecdn.com/00000/20/52/2502_l.jpg",
+    # 	     "userType"=>"RegularUser",
+    # 	     "userId"=>6221,
+    # 	     "image"=>"http://b2.ac-images.myspacecdn.com/00000/20/52/2502_s.jpg"}],
+    # 	  "count"=>1,
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_friends(user_id, params = {})
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_FRIENDS_URL, user_id)
+      call_myspace_api_json(url, :get, params)
+    end
+
+    # Tests whether user +user_id+ is friends with one or more other users:
+    #
+    # 	{"friendship"=>
+    # 	  [{"areFriends"=>true, "friendId"=>6221},
+    # 	   {"areFriends"=>false, "friendId"=>12341234},
+    # 	   {"areFriends"=>true, "friendId"=>456073223}],
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_friendship(user_id, *friend_ids)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      friend_ids.each do |friend_id|
+        friend_id = friend_id.to_s
+        validate_identifier(:friend_ids, friend_id)
+      end
+      url = sprintf(API_FRIENDSHIP_URL, user_id, friend_ids.join(';'))
+      call_myspace_api_json(url)
+    end
+
+    # Gets the mood of user +user_id+:
+    #
+    # 	{"mood"=>"tested",
+    # 	  "moodImageUrl"=>
+    # 	  "http://x.myspacecdn.com/images/blog/moods/iBrads/indescribable.gif",
+    # 	  "moodLastUpdated"=>"2/27/2009 10:19:25 AM",
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_mood(user_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_MOOD_URL, user_id)
+      call_myspace_api_json(url)
+    end
+
+    # Gets the photo descriptions for the photos that belong to user +user_id+:
+    #
+    # 	{"photos"=>
+    # 	  [{"smallImageUri"=>
+    # 	     "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg",
+    # 	     "photoUri"=>"http://api.myspace.com/v1/users/456073223/photos/100809",
+    # 	     "id"=>100809,
+    # 	     "uploadDate"=>"2/27/2009 10:14:12 AM",
+    # 	     "caption"=>"",
+    # 	     "lastUpdatedDate"=>"",
+    # 	     "imageUri"=>
+    # 	     "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	     "user"=>
+    # 	     {"name"=>"Bob",
+    # 	       "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	       "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	       "largeImage"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	       "userType"=>"RegularUser",
+    # 	       "userId"=>456073223,
+    # 	       "image"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}],
+    # 	  "count"=>1,
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_photos(user_id, params = {})
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_PHOTOS_URL, user_id)
+      call_myspace_api_json(url, :get, params)
+    end
+
+    # Gets the photo description for photo +photo_id+ for user +user_id+:
+    #
+    # 	{"smallImageUri"=>
+    # 	  "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg",
+    # 	  "photoUri"=>"http://api.myspace.com/v1/users/456073223/photos/100809",
+    # 	  "id"=>100809,
+    # 	  "uploadDate"=>"2/27/2009 10:14:12 AM",
+    # 	  "caption"=>"",
+    # 	  "lastUpdatedDate"=>"",
+    # 	  "imageUri"=>
+    # 	  "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_photo(user_id, photo_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      photo_id = photo_id.to_s
+      validate_identifier(:photo_id, photo_id)
+      url = sprintf(API_PHOTO_URL, user_id, photo_id)
+      call_myspace_api_json(url)
+    end
+
+    # Gets the profile info for user +user_id+:
+    #
+    # 	{"region"=>"California",
+    # 	  "city"=>"BEVERLY HILLS",
+    # 	  "country"=>"US",
+    # 	  "postalcode"=>"90210",
+    # 	  "gender"=>"Male",
+    # 	  "type"=>"full",
+    # 	  "culture"=>"en-US",
+    # 	  "aboutme"=>"",
+    # 	  "hometown"=>"",
+    # 	  "basicprofile"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userId"=>456073223,
+    # 	    "lastUpdatedDate"=>"2/27/2009 10:20:02 AM",
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"},
+    # 	  "age"=>88,
+    # 	  "maritalstatus"=>"Single"}
+    def get_profile(user_id, params = {})
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_PROFILE_URL, user_id)
+      call_myspace_api_json(url, :get, params)
+    end
+
+    # Gets the status of user +user_id+:
+    #
+    # 	{"mood"=>"tested",
+    # 	  "moodImageUrl"=>
+    # 	  "http://x.myspacecdn.com/images/blog/moods/iBrads/indescribable.gif",
+    # 	  "moodLastUpdated"=>"2/27/2009 10:19:25 AM",
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"},
+    # 	  "status"=>"Testing"}
+    def get_status(user_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_STATUS_URL, user_id)
+      call_myspace_api_json(url)
+    end
+
+    # Gets the video descriptions for the videos of user +user_id+:
+    #
+    # 	{"videos"=>
+    # 	  [{"totalrating"=>"0",
+    # 	     "title"=>"110403na",
+    # 	     "resourceuserid"=>"456073223",
+    # 	     "mediastatus"=>"ProcessingSuccessful",
+    # 	     "dateupdated"=>"3/5/2009 11:24:23 AM",
+    # 	     "country"=>"US",
+    # 	     "totalviews"=>"0",
+    # 	     "thumbnail"=>
+    # 	     "http://d4.ac-videos.myspacecdn.com/videos02/8/thumb1_1bd4f5fde59540c2981c35b27c15a0f3.jpg",
+    # 	     "language"=>"en",
+    # 	     "id"=>53551799,
+    # 	     "totalcomments"=>"0",
+    # 	     "runtime"=>"219",
+    # 	     "datecreated"=>"3/5/2009 11:24:23 AM",
+    # 	     "privacy"=>"Public",
+    # 	     "mediatype"=>"4",
+    # 	     "description"=>"110403na",
+    # 	     "user"=>
+    # 	     {"name"=>"Bob",
+    # 	       "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	       "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	       "largeImage"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	       "userType"=>"RegularUser",
+    # 	       "userId"=>456073223,
+    # 	       "image"=>
+    # 	       "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"},
+    # 	     "totalvotes"=>"0",
+    # 	     "videoUri"=>"http://api.myspace.com/v1/users/456073223/videos/53551799"}],
+    # 	  "count"=>1,
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"}}
+    def get_videos(user_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_VIDEOS_URL, user_id)
+      call_myspace_api_json(url)
+    end
+
+    # Gets the video description for the video +video_id+ of user +user_id+:
+    #
+    # 	{"totalrating"=>"0",
+    # 	  "title"=>"110403na",
+    # 	  "resourceuserid"=>"456073223",
+    # 	  "mediastatus"=>"ProcessingSuccessful",
+    # 	  "dateupdated"=>"3/5/2009 11:24:23 AM",
+    # 	  "country"=>"US",
+    # 	  "totalviews"=>"0",
+    # 	  "thumbnail"=>
+    # 	  "http://d1.ac-videos.myspacecdn.com/videos02/8/thumb1_461592d881c14023bcb6a73275ebc614.jpg",
+    # 	  "language"=>"en",
+    # 	  "id"=>53551799,
+    # 	  "totalcomments"=>"0",
+    # 	  "runtime"=>"219",
+    # 	  "datecreated"=>"3/5/2009 11:24:23 AM",
+    # 	  "privacy"=>"Public",
+    # 	  "mediatype"=>"4",
+    # 	  "description"=>"110403na",
+    # 	  "user"=>
+    # 	  {"name"=>"Bob",
+    # 	    "uri"=>"http://api.myspace.com/v1/users/456073223",
+    # 	    "webUri"=>"http://www.myspace.com/bobvontestacount",
+    # 	    "largeImage"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/l_f820313641924f0f90004932c8bc310c.jpg",
+    # 	    "userType"=>"RegularUser",
+    # 	    "userId"=>456073223,
+    # 	    "image"=>
+    # 	    "http://c1.ac-images.myspacecdn.com/images02/45/s_f820313641924f0f90004932c8bc310c.jpg"},
+    # 	  "totalvotes"=>"0",
+    # 	  "videoUri"=>"http://api.myspace.com/v1/users/456073223/videos/53551799"}
+    def get_video(user_id, video_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      video_id = video_id.to_s
+      validate_identifier(:video_id, video_id)
+      url = sprintf(API_VIDEO_URL, user_id, video_id)
+      call_myspace_api_json(url)
+    end
+
+    def get_activities(user_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_ACTIVITIES_URL, user_id)
+      call_myspace_api_xml(url)
+    end
+
+    def get_friends_activities(user_id)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_FRIENDS_ACTIVITIES_URL, user_id)
+      call_myspace_api_xml(url)
+    end
+
+    def set_status(user_id, status)
+      user_id = user_id.to_s
+      validate_identifier(:user_id, user_id)
+      url = sprintf(API_STATUS_PUT_URL, user_id)
+      call_myspace_api_xml(url, :put, {:body => {:status => status}})
+    end
+
+    def call_myspace_api(url, method = :get, params = {}, &block)
+      params = params.dup
+      body = params.delete(:body)
+      headers = params.delete(:headers)
+      query_str = params.collect do |key, value|
+        CGI.escape(key.to_s) + '=' + CGI.escape(value.to_s)
+      end.join('&')
+
+      url << '?' + query_str if query_str.length > 0
+
+      @http_logger.info("sending: '#{url}'") if @http_logger
+      resp = @access_token.request(method, url, body, headers)
+      @http_logger.info("received: '#{resp.code}': '#{resp.body}'") if @http_logger
+
+      validate_response(resp, url)
+      yield(resp.body)
+    end
+
+    def call_myspace_api_json(url, method = :get, params = {})
+      call_myspace_api(url, method, params) do |body|
+        JSON::parse(body)
+      end
+    end
+
+    def call_myspace_api_xml(url, method = :get, params = {})
+      call_myspace_api(url, method, params) do |body|
+        REXML::Document.new(body)
+      end
+    end
+
+    protected
+
+    ID_REGEXP = /[0-9]+/ unless const_defined?('ID_REGEXP')
+
+    def validate_identifier(parameter, identifier)
+      raise BadIdentifier.new(parameter, identifier) unless identifier && identifier =~ ID_REGEXP
+    end
+
+    def validate_response(response, url)
+      code = response.code
+      case code
+      when '200'
+        return
+      when '201'
+        return
+      when '401'
+        raise PermissionDenied.new(code, response.message, url)
+      else
+        raise RestException.new(code, response.message, url) unless ['200', '201'].include?(code)
+      end
+    end
+  end
+end