yt_analytics 0.0.1

data/README.rdoc

@@ -0,0 +1,347 @@
+== YOUTUBE_IT {<img src="https://secure.travis-ci.org/kylejginavan/youtube_it.png"/>}[http://travis-ci.org/kylejginavan/youtube_it]
+
+== DONATION
+
+  YOUTUBE_IT is developed by many contributors who are passioned about opensource projects 
+  and selflessly donate their time and work. Following that spirit your donations to this project 
+  will be destined to the Tuquito Libre Foundation(http://fundacion.tuquito.org.ar) for developing 
+  technology projects intended to close the digital gap in Latin America.
+
+{<img src=https://www.pledgie.com/campaigns/16746.png?skin_name=chrome>}[http://www.pledgie.com/campaigns/16746]
+
+== DESCRIPTION
+
+  youtube_it is the most complete Ruby client for the YouTube GData API. It provides an easy
+  way to access the latest and most complete access to YouTube's video API.
+  In comparison with the earlier Youtube interfaces, this new API and
+  library offers much-improved flexibility around executing complex search
+  queries to obtain well-targeted video search results.  In addition, standard video management 
+  including but not limited to uploading, deleting, updating, like, dislike, ratings and
+  comments.
+  
+== INSTALLATION & SETUP:
+  * Create a youtube account.
+  * Create a developer key here http://code.google.com/apis/youtube/dashboard.
+  * sudo gem install youtube_it
+
+Note: youtube_it supports ClientLogin(YouTube account), OAuth or AuthSub authentication methods.
+
+== Example Rails 3 App
+
+You can get an example how you can use youtube_it with Rails 3 here: http://github.com/chebyte/youtube_it_rails_app_example
+
+== DEMO
+
+You can see to youtube_it in action here: http://youtube-it.heroku.com
+
+== ESTABLISHING A CLIENT
+
+Important: The Account Authentication API for OAuth 1.0, AuthSub and Client Login has been officially deprecated as of April 20, 2012. It will continue to work as per our deprecation policy(https://developers.google.com/accounts/terms), but we encourage you to migrate to OAuth 2.0 authentication as soon as possible. If you are building a new application, you should use OAuth 2.0 authentication.
+
+Creating a client:
+  $ require 'youtube_it'
+  $ client = YouTubeIt::Client.new
+
+Client with developer key:
+  $ client = YouTubeIt::Client.new(:dev_key => "developer_key")
+    
+Client with youtube account and developer key:
+  $ client = YouTubeIt::Client.new(:username => "youtube_username", :password =>  "youtube_passwd", :dev_key => "developer_key")
+
+Client with AuthSub:
+    $ client = YouTubeIt::AuthSubClient.new(:token => "token" , :dev_key => "developer_key")
+
+Client with OAuth:
+  $ client = YouTubeIt::OAuthClient.new("consumer_key", "consumer_secret", "youtube_username", "developer_key")
+  $ client.authorize_from_access("access_token", "access_secret")
+
+Client with OAuth2:
+  $ client = YouTubeIt::OAuth2Client.new(client_access_token: "access_token", client_refresh_token: "refresh_token", client_id: "client_id", client_secret: "client_secret", dev_key: "dev_key", expires_at: "expiration time")
+
+If your access token is still valid (be careful, access tokens may only be valid for about 1 hour), you can use the client directly. If you want to refresh the access token using the refresh token just do:
+
+  $ client.refresh_access_token!
+
+* You can see more about oauth 2 in the wiki: https://github.com/kylejginavan/youtube_it/wiki/How-To:-Use-OAuth-2
+
+== PROFILES
+  you can use multiple profiles in the same account like that
+
+  $ profiles = client.profiles(['username1','username2']) 
+  $ profiles['username1'].username, "username1"
+
+== VIDEO QUERIES
+
+Note:  Each type of client enables searching capabilities.
+
+Basic Queries:
+  $ client.videos_by(:query => "penguin")
+  $ client.videos_by(:query => "penguin", :page => 2, :per_page => 15)
+  $ client.videos_by(:query => "penguin", :restriction => "DE")
+  $ client.videos_by(:tags => ['tiger', 'leopard'])
+  $ client.videos_by(:categories => [:news, :sports])
+  $ client.videos_by(:categories => [:news, :sports], :tags => ['soccer', 'football'])
+  $ client.videos_by(:user => 'liz')
+  $ client.videos_by(:favorites, :user => 'liz')
+  $ client.video_by("FQK1URcxmb4")
+  $ client.video_by("https://www.youtube.com/watch?v=QsbmrCtiEUU")  
+  $ client.video_by_user("chebyte","FQK1URcxmb4")
+
+Standard Queries:
+  $ client.videos_by(:most_viewed)
+  $ client.videos_by(:most_linked, :page => 3)
+  $ client.videos_by(:top_rated, :time => :today)
+
+Advanced Queries (with boolean operators OR (either), AND (include), NOT (exclude)):
+  $ client.videos_by(:categories => { :either => [:news, :sports], :exclude => [:comedy] }, :tags => { :include => ['football'], :exclude => ['soccer'] })
+
+
+Custom Query Params
+ You can use custom query params like that:
+
+   $ client.videos_by(:query => "penguin", :safe_search => "strict")
+   $ client.videos_by(:query => "penguin", :duration => "long")
+   $ client.videos_by(:query => "penguin", :hd => "true")
+   $ client.videos_by(:query => "penguin", :region => "AR")
+
+ you can see more options here https://developers.google.com/youtube/2.0/reference#yt_format
+
+Fields Parameter(experimental features):
+  Return videos more than 1000 views
+  $ client.videos_by(:fields => {:view_count => "1000"})
+
+  Filter by date
+  $ client.videos_by(:fields => {:published  => ((Date.today)})
+  $ client.videos_by(:fields => {:recorded   => ((Date.today)})  
+
+  Filter by date with range
+  $ client.videos_by(:fields => {:published  => ((Date.today - 30)..(Date.today))})
+  $ client.videos_by(:fields => {:recorded   => ((Date.today - 30)..(Date.today))})  
+  
+Note: These queries do not find private videos! Use these methods instead:
+  $ client.get_my_video("FQK1URcxmb4")
+  $ client.get_my_videos(:query => "penguin")
+
+== VIDEO MANAGEMENT
+
+Note: YouTube account, OAuth or AuthSub enables video management.
+
+Upload Video:
+  $ client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test])
+
+Upload Video With A Developer Tag (Note the tags are not immediately available):
+  $ client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test], :dev_tag => 'tagdev')
+
+Upload Private Video:
+  $ client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test], :private => true)
+
+
+Update Video:
+  $ client.video_update("FQK1URcxmb4", :title => "new test",:description => 'new description', :category => 'People',:keywords => %w[cool blah test])
+
+Delete Video:
+  $ client.video_delete("FQK1URcxmb4")
+
+My Videos:
+  $ client.my_videos
+
+My Video:
+  $ client.my_video(video_id)
+
+Profile Details:
+  $ client.profile(user) #default: current user
+
+List Comments:
+  $ client.comments(video_id)
+
+Add A Comment:
+  $ client.add_comment(video_id, "test comment!")
+
+Add A Reply Comment:
+  $ client.add_comment(video_id, "test reply!", :reply_to => another_comment)
+
+Delete A Comment:
+  $ client.delete_comment(video_id, comment_id)
+
+List Favorites:
+  $ client.favorites(user) # default: current user
+
+Add Favorite:
+  $ client.add_favorite(video_id)
+
+Delete Favorite:
+  $ client.delete_favorite(favorite_entry_id)
+
+Like A Video:
+  $ client.like_video(video_id)
+
+Dislike A Video:
+  $ client.dislike_video(video_id)
+
+List Subscriptions:
+  $ client.subscriptions(user) # default: current user
+
+Subscribe To A Channel:
+  $ client.subscribe_channel(channel_name)
+
+Unsubscribe To A Channel:
+  $ client.unsubscribe_channel(subscription_id)
+
+List New Subscription Videos:
+  $ client.new_subscription_videos(user) # default: current user
+  
+List Playlists:
+  $ client.playlists(user, order_by) # default: current user, position
+
+  for example you can get the videos of your playlist ordered by title
+
+  $ client.playlists(user, "title")
+
+  you can see more about options for order_by here: https://developers.google.com/youtube/2.0/reference#orderbysp
+
+Select Playlist:
+  $ client.playlist(playlist_id)
+
+Select All Videos From A Playlist:
+  $ playlist = client.playlist(playlist_id)
+  $ playlist.videos
+
+Create Playlist:
+  $ playlist = client.add_playlist(:title => "new playlist", :description => "playlist description")
+
+Delete Playlist:
+  $ client.delete_playlist(playlist_id)
+
+Add Video To Playlist:
+  $ client.add_video_to_playlist(playlist_id, video_id)
+
+Remove Video From Playlist:
+  $ client.delete_video_from_playlist(playlist_id, playlist_entry_id)
+
+Select All Videos From your Watch Later Playlist:
+  $ watcher_later = client.watcherlater(user) #default: current user
+  $ watcher_later.videos
+
+Add Video To Watcher Later Playlist:
+  $ client.add_video_to_watchlater(video_id)
+
+Remove Video From Watch Later Playlist:
+  $ client.delete_video_from_watchlater(watchlater_entry_id)
+
+
+List Related Videos
+  $ video = client.video_by("https://www.youtube.com/watch?v=QsbmrCtiEUU&feature=player_embedded")
+  $ video.related.videos
+
+Add Response Video
+  $ video.add_response(original_video_id, response_video_id)
+
+Delete Response Video
+  $ video.delete_response(original_video_id, response_video_id)
+
+List Response Videos
+  $ video = client.video_by("https://www.youtube.com/watch?v=QsbmrCtiEUU&feature=player_embedded")
+  $ video.responses.videos
+
+  
+== ACCESS CONTROL LIST
+
+  You can give permissions in your videos, for example denied comments, rate, etc...
+  you can read more there http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:accessControl
+  you have available the followings options:
+
+* :rate, :comment, :commentVote, :videoRespond, :list, :embed, :syndicate
+
+  with just two values:
+*    allowed or denied
+
+  Example
+
+  client = YouTubeIt::Client.new(:username => "youtube_username", :password =>  "youtube_passwd", :dev_key => "developer_key")
+
+* upload video with denied comments
+
+  client.video_upload(File.open("test.mov"), :title => "test",:description => 'some description', :category => 'People',:keywords => %w[cool blah test], :comment => "denied")
+
+== User Activity
+ You can get user activity with the followings params:
+ 
+ $ client.activity(user) #default current user
+ 
+== Video Upload From Browser:
+
+When uploading a video from your browser you need make a form upload with the followings params:
+  $ upload_token(params, nexturl)
+params  => params like :title => "title", :description => "description", :category => "People", :tags => ["test"]
+nexturl => redirect to this url after upload
+
+
+Controller
+  def upload
+    @upload_info = YouTubeIt::Client.new.upload_token(params, videos_url)
+  end
+
+View (upload.html.erb)
+  <% form_tag @upload_info[:url], :multipart => true do %>
+    <%= hidden_field_tag :token, @upload_info[:token] %>
+    <%= label_tag :file %>
+    <%= file_field_tag :file %>
+    <%= submit_tag "Upload video" %>
+  <% end %>
+
+== WIDESCREEN VIDEOS
+
+If the videos has support for widescreen:
+  $ video.embed_html_with_width(1280)
+
+Note: you can specify width or just use the default of 1280.
+
+== USING HTML5
+
+Now you can embed videos without use flash using html5, usefull for mobiles that not support flash but has html5 browser
+
+You can specify these options
+  $ video.embed_html5({:class => 'video-player', :id => 'my-video', :width => '425', :height => '350', :frameborder => '1', :url_params => {:option_one => "value", :option_two => "value"}})
+
+or just use with default options
+  $ video.embed_html5 #default: width: 425, height: 350, frameborder: 0
+
+== LOGGING
+
+YouTubeIt passes all logs through the logger variable on the class itself. In Rails context, assign the Rails logger to that variable to collect the messages
+(don't forget to set the level to debug):
+  $ YouTubeIt.logger = RAILS_DEFAULT_LOGGER
+  $ RAILS_DEFAULT_LOGGER.level = Logger::DEBUG
+
+== CONTRIBUTORS:
+
+* Kyle J. Ginavan.
+* Mauro Torres - http://github.com/chebyte
+* Marko Seppa  - https://github.com/mseppae
+* Walter Korman - https://github.com/shaper
+* Shane Vitarana - https://github.com/shanev
+
+== LICENSE:
+
+MIT License
+
+Copyright (c) 2010 Kyle J. Ginavan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/yt_analytics/client.rb

@@ -0,0 +1,146 @@
+class YTAnalytics
+  class Client
+    include YTAnalytics::Logging
+    # Previously this was a logger instance but we now do it globally
+
+    def initialize *params
+      if params.first.is_a?(Hash)
+        hash_options = params.first
+        @user = hash_options[:username]
+        @pass = hash_options[:password]
+        @dev_key = hash_options[:dev_key]
+        @client_id = hash_options[:client_id] || "yt_analytics"
+        @legacy_debug_flag = hash_options[:debug]
+      elsif params.first
+        puts "* warning: the method YTAnalytics::Client.new(user, passwd, dev_key) is deprecated, use YTAnalytics::Client.new(:username => 'user', :password => 'passwd', :dev_key => 'dev_key')"
+        @user = params.shift
+        @pass = params.shift
+        @dev_key = params.shift
+        @client_id = params.shift || "youtube_it"
+        @legacy_debug_flag = params.shift
+      end
+    end
+
+    def enable_http_debugging
+      client.enable_http_debugging
+    end
+
+    def current_user
+      client.get_current_user
+    end
+
+    # Gets the authenticated users video with the given ID. It may be private.
+    def my_video(video_id)
+      client.get_my_video(video_id)
+    end
+
+    # Gets all videos 
+    def my_videos(opts = {})
+      client.get_my_videos(opts)
+    end
+
+    # Gets the user's watch history
+    def watch_history
+      client.get_watch_history
+    end
+
+    def analytics(opts = {})
+      client.get_analytics(opts)
+    end
+
+    def seven_day_totals(start_date = 2.day.ago, end_date = 2.day.ago)
+      client.temporal_totals('7DayTotals',start_date, end_date, self.user_id)
+    end
+
+    def thirty_day_totals(start_date = 2.day.ago, end_date = 2.day.ago)
+      client.temporal_totals('30DayTotals',start_date, end_date, self.user_id)
+    end
+
+    def day_totals(start_date = 2.day.ago, end_date = 2.day.ago)
+      client.temporal_totals('day',start_date, end_date, self.user_id)
+    end
+
+    def month_totals(start_date = 2.day.ago, end_date = 2.day.ago)
+      client.temporal_totals('month',start_date, end_date, self.user_id)
+    end
+
+    private
+
+    def client
+      @client ||= YTAnalytics::YTAuth::Authentication.new(:username => @user, :password => @pass, :dev_key => @dev_key)
+    end
+
+    def calculate_offset(page, per_page)
+      page == 1 ? 1 : ((per_page * page) - per_page + 1)
+    end
+
+    def integer_or_default(value, default)
+      value = value.to_i
+      value > 0 ? value : default
+    end
+  end
+
+  class OAuth2Client < YTAnalytics::Client
+    def initialize(options)
+      @client_id = options[:client_id]
+      @client_secret = options[:client_secret]
+      @client_access_token = options[:client_access_token]
+      @client_refresh_token = options[:client_refresh_token]
+      @client_token_expires_at = options[:client_token_expires_at]
+      @dev_key = options[:dev_key]
+      @legacy_debug_flag = options[:debug]
+    end
+
+    def oauth_client
+      options = {:site => "https://accounts.google.com",
+        :authorize_url => '/o/oauth2/auth',
+        :token_url => '/o/oauth2/token'
+       }
+      options.merge(:connection_opts => @connection_opts) if @connection_opts
+      @oauth_client ||= ::OAuth2::Client.new(@client_id, @client_secret, options)
+    end
+
+    def access_token
+      @access_token ||= ::OAuth2::AccessToken.new(oauth_client, @client_access_token, :refresh_token => @client_refresh_token, :expires_at => @client_token_expires_at)
+    end
+
+    def refresh_access_token!
+      new_access_token = access_token.refresh!
+      require 'thread' unless Thread.respond_to?(:exclusive)
+      Thread.exclusive do
+        @access_token = new_access_token
+        @client = nil
+      end
+      @access_token
+    end
+        
+    def session_token_info
+      response = Faraday.get("https://www.googleapis.com/oauth2/v1/tokeninfo?access_token=#{@client_access_token}")
+      {:code => response.status, :body => response.body }
+    end
+
+    def current_user
+      profile = access_token.get("http://gdata.youtube.com/feeds/api/users/default")
+      response_code = profile.status
+
+      if response_code/10 == 20 # success
+        Nokogiri::XML(profile.body).at("entry/author/name").text
+      elsif response_code == 403 || response_code == 401 # auth failure
+        raise YTAnalytics::YTAuth::AuthenticationError.new(profile.inspect, response_code)
+      else
+        raise YTAnalytics::YTAuth::UploadError.new(profile.inspect, response_code)
+      end
+    end
+
+    def user_id
+      profile ||= access_token.get("http://gdata.youtube.com/feeds/api/users/default?v=2&alt=json").parsed
+      profile['entry']['author'][0]["yt$userId"]["$t"]
+    end
+
+    private
+
+    def client
+      @client ||= YTAnalytics::YTAuth::Authentication.new(:username => current_user, :access_token => access_token, :dev_key => @dev_key)
+    end
+  end
+end

data/lib/yt_analytics/middleware/faraday_authheader.rb

@@ -0,0 +1,24 @@
+module Faraday
+  class Request::AuthHeader < Faraday::Middleware
+
+    def call(env)
+      req_headers = env[:request_headers]
+      req_headers.merge!(@headers)
+      unless req_headers.include?("GData-Version")
+        req_headers.merge!("GData-Version" => "2")
+      end
+      unless req_headers.include?("Content-Type")
+        req_headers.merge!("Content-Type"  => "application/atom+xml; charset=UTF-8")
+      end
+      unless req_headers.include?("Content-Length")
+        req_headers.merge!("Content-Length"  => env[:body] ? "#{env[:body].length}" : "0")
+      end
+
+      @app.call(env)
+    end
+
+    def initialize(app, headers)
+      @app, @headers = app, headers
+    end
+  end
+end

data/lib/yt_analytics/middleware/faraday_oauth.rb

@@ -0,0 +1,21 @@
+module Faraday
+  class Request::OAuth < Faraday::Middleware
+    dependency 'simple_oauth'
+
+    def call(env)
+      params = env[:body].is_a?(Hash) ? env[:body] : {}
+
+      signature_params = params.reject{ |k,v| v.respond_to?(:content_type) }
+
+      header = SimpleOAuth::Header.new(env[:method], env[:url], signature_params, @options)
+
+      env[:request_headers]['Authorization'] = header.to_s
+
+      @app.call(env)
+    end
+
+    def initialize(app, options)
+      @app, @options = app, options
+    end
+  end
+end

data/lib/yt_analytics/middleware/faraday_oauth2.rb

@@ -0,0 +1,13 @@
+module Faraday
+  class Request::OAuth2 < Faraday::Middleware
+    def call(env)
+      env[:request_headers]['Authorization'] = "Bearer #{@access_token.token}"
+
+      @app.call(env)
+    end
+
+    def initialize(app, access_token)
+      @app, @access_token = app, access_token
+    end
+  end
+end

data/lib/yt_analytics/middleware/faraday_yt_analytics.rb

@@ -0,0 +1,31 @@
+module Faraday
+  class Response::YTAnalytics < Response::Middleware
+    def parse_upload_error_from(string)
+      xml = Nokogiri::XML(string).at('errors')
+      if xml
+        xml.css("error").inject('') do |all_faults, error|
+          if error.at("internalReason")
+            msg_error = error.at("internalReason").text
+          elsif error.at("location")
+            msg_error = error.at("location").text[/media:group\/media:(.*)\/text\(\)/,1]
+          else
+            msg_error = "Unspecified error"
+          end
+          code = error.at("code").text if error.at("code")
+          all_faults + sprintf("%s: %s\n", msg_error, code)
+        end
+      else
+        string[/<TITLE>(.+)<\/TITLE>/, 1] || string
+      end
+    end
+
+    def on_complete(env) #this method is called after finish request
+      msg = env[:body] ? parse_upload_error_from(env[:body].gsub(/\n/, '')) : ''
+      if env[:status] == 403 || env[:status] == 401
+        raise ::AuthenticationError.new(msg, env[:status])
+      elsif env[:status] / 10 != 20
+        raise ::UploadError.new(msg, env[:status])
+      end
+    end
+  end
+end

data/lib/yt_analytics/model/temporal_metrics.rb

@@ -0,0 +1,25 @@
+class YTAnalytics
+  module Model #:nodoc:
+    class TemporalMetrics #:nodoc:
+
+      include YTAnalytics::Logging
+      attr_accessor :end_date, :views, :comments, :favorites_added, :favorites_removed, :likes, :dislikes, :shares, :subscribers_gained, :subscribers_lost, :uniques
+
+
+      def initialize params
+        @end_date = params[:endDate]
+        @views = params[:views]
+        @comments = params[:comments]
+        @favorites_added = params[:favoritesAdded]
+        @favorites_removed = params[:favoritesRemoved]
+        @likes = params[:likes]
+        @dislikes = params[:dislikes]
+        @shares = params[:shares]
+        @subscribers_gained = params[:subscribersGained]
+        @subscribers_lost = params[:subscribersLost]
+        @uniques = params[:uniques]
+      end
+      
+    end
+  end
+end

data/lib/yt_analytics/parser.rb

@@ -0,0 +1,77 @@
+# encoding: UTF-8
+
+class YTAnalytics
+  module Parser #:nodoc:
+    class FeedParser #:nodoc:
+      def initialize(content)
+        @content = (content =~ URI::regexp(%w(http https)) ? open(content).read : content)
+
+      rescue OpenURI::HTTPError => e
+        raise OpenURI::HTTPError.new(e.io.status[0],e)
+      rescue
+        @content = content
+
+      end
+
+      def parse
+        parse_content @content
+      end
+
+      def parse_single_entry
+        doc = Nokogiri::XML(@content)
+        parse_entry(doc.at("entry") || doc)
+      end
+
+      def parse_videos
+        doc = Nokogiri::XML(@content)
+        videos = []
+        doc.css("entry").each do |video|
+          videos << parse_entry(video)
+        end
+        videos
+      end
+
+      def remove_bom str
+        str.gsub /\xEF\xBB\xBF|/, ''
+      end
+    end
+
+
+    class TemporalParser < FeedParser
+
+    private
+      def parse_content(content)
+        temporal_metrics = []
+        if content.is_a? Hash and content["rows"].is_a? Array and content["rows"].length > 0
+
+          headers = content["columnHeaders"]
+
+          content["rows"].each do |row|
+            metrics = {}
+
+            headers.each_with_index do |column,i|
+              if column["columnType"] == "DIMENSION"
+                metrics[:endDate] = Date.strptime row[i], "%Y-%m-%d"
+              elsif column["columnType"] == "METRIC"
+                metrics[eval(":" + column["name"])] = row[i]
+              end
+            end
+            temporal_metrics.push(YTAnalytics::Model::TemporalMetrics.new(metrics))
+          end
+
+          temporal_metrics.sort { |a,b| a.end_date <=> b.end_date }
+        end
+        temporal_metrics
+      end
+    end
+
+    class AnalyticsParser < FeedParser #:nodoc:
+
+    private
+      def parse_content(content)
+        entry = JSON.parse(content)
+      end
+    end
+  end
+end
+

data/lib/yt_analytics/request/authentication.rb

@@ -0,0 +1,144 @@
+class YTAnalytics
+  module YTAuth
+
+    class UploadError < YTAnalytics::Error; end
+
+    class AuthenticationError < YTAnalytics::Error; end
+
+    class Authentication
+      include YTAnalytics::Logging
+
+      def initialize *params
+        if params.first.is_a?(Hash)
+          hash_options = params.first
+          @user                          = hash_options[:username]
+          @password                      = hash_options[:password]
+          @dev_key                       = hash_options[:dev_key]
+          @access_token                  = hash_options[:access_token]
+          @authsub_token                 = hash_options[:authsub_token]
+          @client_id                     = hash_options[:client_id] || "youtube_it"
+          @config_token                  = hash_options[:config_token]
+        else
+          puts "* warning: the method YTAnalytics::Auth::Authentication.new(username, password, dev_key) is deprecated, use YouTubeIt::Upload::VideoUpload.new(:username => 'user', :password => 'passwd', :dev_key => 'dev_key')"
+          @user                          = params.shift
+          @password                      = params.shift
+          @dev_key                       = params.shift
+          @access_token                  = params.shift
+          @authsub_token                 = params.shift
+          @client_id                     = params.shift || "youtube_it"
+          @config_token                  = params.shift
+        end
+      end
+
+
+      def enable_http_debugging
+        @http_debugging = true
+      end
+
+     
+
+      def get_current_user
+        current_user_url = "/feeds/api/users/default"
+        response         = yt_session.get(current_user_url)
+
+        return Nokogiri::XML(response.body).at("entry/author/name").text
+      end
+
+      def get_analytics(opts)
+        # max_results = opts[:per_page] || 50
+        # start_index = ((opts[:page] || 1) -1) * max_results +1
+        get_url     = "/youtube/analytics/v1/reports?"
+        get_url     << opts.collect { |k,p| [k,p].join '=' }.join('&')
+        response    = yt_session('https://www.googleapis.com').get(get_url)
+
+        return YTAnalytics::Parser::AnalyticsParser.new(response.body).parse
+      end
+
+      def temporal_totals(dimension, start_date, end_date, user_id)
+        #dimension is either day, 7DayTotals, 30DayTotals, or month
+        opts = {'end-date'=>end_date.strftime("%Y-%m-%d"),'ids' => "channel==#{user_id}", 'metrics' => 'views,comments,favoritesAdded,favoritesRemoved,likes,dislikes,shares,subscribersGained,subscribersLost,uniques','start-date' => start_date.strftime("%Y-%m-%d"),'dimensions' => dimension}
+        get_url     = "/youtube/analytics/v1/reports?"
+        get_url     << opts.collect { |k,p| [k,p].join '=' }.join('&')
+        response    = yt_session('https://www.googleapis.com').get(get_url)
+        content = JSON.parse(response.body)
+        return YTAnalytics::Parser::TemporalParser.new(content).parse
+      end
+
+
+      private
+
+
+      def base_url
+        "http://gdata.youtube.com"
+      end
+
+      def authorization_headers
+        header = {"X-GData-Client"  => "#{@client_id}"}
+        header.merge!("X-GData-Key" => "key=#{@dev_key}") if @dev_key
+        if @authsub_token
+          header.merge!("Authorization"  => "AuthSub token=#{@authsub_token}")
+        elsif @access_token.nil? && @authsub_token.nil? && @user
+          header.merge!("Authorization"  => "GoogleLogin auth=#{auth_token}")
+        end
+        header
+      end
+
+      def parse_upload_error_from(string)
+        xml = Nokogiri::XML(string).at('errors')
+        if xml
+          xml.css("error").inject('') do |all_faults, error|
+            if error.at("internalReason")
+              msg_error = error.at("internalReason").text
+            elsif error.at("location")
+              msg_error = error.at("location").text[/media:group\/media:(.*)\/text\(\)/,1]
+            else
+              msg_error = "Unspecified error"
+            end
+            code = error.at("code").text if error.at("code")
+            all_faults + sprintf("%s: %s\n", msg_error, code)
+          end
+        else
+          string[/<TITLE>(.+)<\/TITLE>/, 1] || string
+        end
+      end
+
+      # def raise_on_faulty_response(response)
+      #   response_code = response.code.to_i
+      #   msg = parse_upload_error_from(response.body.gsub(/\n/, ''))
+
+      #   if response_code == 403 || response_code == 401
+      #   #if response_code / 10 == 40
+      #     raise AuthenticationError.new(msg, response_code)
+      #   elsif response_code / 10 != 20 # Response in 20x means success
+      #     raise UploadError.new(msg, response_code)
+      #   end
+      # end
+
+      def auth_token
+        @auth_token ||= begin
+          http  = Faraday.new("https://www.google.com", :ssl => {:verify => false})
+          body = "Email=#{YTAnalytics.esc @user}&Passwd=#{YTAnalytics.esc @password}&service=youtube&source=#{YTAnalytics.esc @client_id}"
+          response = http.post("/youtube/accounts/ClientLogin", body, "Content-Type" => "application/x-www-form-urlencoded")
+          raise ::AuthenticationError.new(response.body[/Error=(.+)/,1], response.status.to_i) if response.status.to_i != 200
+          @auth_token = response.body[/Auth=(.+)/, 1]
+        end
+      end
+
+      def yt_session(url = nil)
+        Faraday.new(:url => (url ? url : base_url), :ssl => {:verify => false}) do |builder|
+          if @access_token
+            if @config_token
+              builder.use Faraday::Request::OAuth, @config_token
+            else
+              builder.use Faraday::Request::OAuth2, @access_token
+            end
+          end
+          builder.use Faraday::Request::AuthHeader, authorization_headers
+          builder.use Faraday::Response::YTAnalytics
+          builder.adapter YTAnalytics.adapter
+
+        end
+      end
+    end
+  end
+end

data/lib/yt_analytics/version.rb

@@ -0,0 +1,4 @@
+class YTAnalytics
+  VERSION = '0.0.1'
+end
+

data/lib/yt_analytics.rb

@@ -0,0 +1,71 @@
+require 'logger'
+require 'open-uri'
+require 'net/https'
+require 'digest/md5'
+require 'nokogiri'
+require 'builder'
+require 'oauth'
+require 'oauth2'
+require 'faraday'
+
+class YTAnalytics
+
+  # Base error class for the extension
+  class Error < RuntimeError
+    attr_reader :code
+    def initialize(msg, code = 0)
+      super(msg)
+      @code = code
+    end
+  end
+
+  def self.esc(s) #:nodoc:
+    CGI.escape(s.to_s)
+  end
+
+  # Set the logger for the library
+  def self.logger=(any_logger)
+    @logger = any_logger
+  end
+
+  # Get the logger for the library (by default will log to STDOUT). TODO: this is where we grab the Rails logger too
+  def self.logger
+    @logger ||= create_default_logger
+  end
+
+  def self.adapter=(faraday_adapter)
+    @adapter = faraday_adapter
+  end
+  
+  def self.adapter
+    @adapter ||= Faraday.default_adapter
+  end
+  
+  # Gets mixed into the classes to provide the logger method
+  module Logging #:nodoc:
+
+    # Return the base logger set for the library
+    def logger
+      YTAnalytics.logger
+    end
+  end
+
+  private
+    def self.create_default_logger
+      logger = Logger.new(STDOUT)
+      logger.level = Logger::DEBUG
+      logger
+    end
+end
+
+%w(
+  version
+  client
+  parser
+  model/temporal_metrics
+  request/authentication
+  middleware/faraday_authheader.rb
+  middleware/faraday_oauth.rb
+  middleware/faraday_oauth2.rb
+  middleware/faraday_yt_analytics.rb
+).each{|m| require File.dirname(__FILE__) + '/yt_analytics/' + m }

data/yt_analytics.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+
+$:.push File.expand_path("../lib", __FILE__)
+
+# Maintain your gem's version:
+require File.dirname(__FILE__) + "/lib/yt_analytics/version"
+
+Gem::Specification.new do |s|
+  s.name        = "yt_analytics"
+  s.version     = YTAnalytics::VERSION
+  s.authors     = %w(drewbaumann sstavrop)
+  s.email       = %w(drewbaumann@gmail.com)
+  s.description = "Upload, delete, update, comment on youtube videos all from one gem."
+  s.summary     = "The most complete Ruby wrapper for youtube api's"
+  s.homepage    = "http://github.com/fullscreeninc/yt_analytics"
+
+  s.add_runtime_dependency("nokogiri", "~> 1.5.2")
+  s.add_runtime_dependency("oauth", "~> 0.4.4")
+  s.add_runtime_dependency("oauth2", "~> 0.6")
+  s.add_runtime_dependency("simple_oauth", "~> 0.1.5")
+  s.add_runtime_dependency("faraday", "~> 0.8")
+  s.add_runtime_dependency("builder", ">= 0")
+
+  s.files = Dir.glob("lib/**/*") + %w(README.rdoc yt_analytics.gemspec)
+
+  s.extra_rdoc_files = %w(README.rdoc)
+end
+

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: yt_analytics
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- drewbaumann
+- sstavrop
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.5.2
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.4
+- !ruby/object:Gem::Dependency
+  name: oauth2
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: simple_oauth
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.5
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: builder
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Upload, delete, update, comment on youtube videos all from one gem.
+email:
+- drewbaumann@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+files:
+- lib/yt_analytics/client.rb
+- lib/yt_analytics/middleware/faraday_authheader.rb
+- lib/yt_analytics/middleware/faraday_oauth.rb
+- lib/yt_analytics/middleware/faraday_oauth2.rb
+- lib/yt_analytics/middleware/faraday_yt_analytics.rb
+- lib/yt_analytics/model/temporal_metrics.rb
+- lib/yt_analytics/parser.rb
+- lib/yt_analytics/request/authentication.rb
+- lib/yt_analytics/version.rb
+- lib/yt_analytics.rb
+- README.rdoc
+- yt_analytics.gemspec
+homepage: http://github.com/fullscreeninc/yt_analytics
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: The most complete Ruby wrapper for youtube api's
+test_files: []