yt_analytics 0.0.2 → 0.0.3

data/lib/yt_analytics/client.rb

@@ -49,6 +49,16 @@ class YTAnalytics
       client.temporal_totals('month',self.user_id, options)
     end
 
+    ### DEMOGRAPHICS METRICS
+    def demographic_percentages(options = {})
+      client.demographic_percentages(self.user_id, options)
+    end
+
+    ### WATCH TIME METRICS
+    def day_watch_time(options = {})
+      client.watch_time_metrics('day', self.user_id, options)
+    end
+
     private
 
     def client

data/lib/yt_analytics/model/demographic_metrics.rb

@@ -0,0 +1,64 @@
+class YTAnalytics
+  module Model #:nodoc:
+    class DemographicMetrics #:nodoc:
+
+      include YTAnalytics::Logging
+
+      attr_accessor :end_date, :age13_17female, :age55_64female, :age65_female, :age25_34male, :age25_34female, :age55_64male, 
+        :age45_54female, :age35_44female, :age18_24female, :age65_male, :age35_44male, :age45_54male, :age18_24male, :age13_17male
+
+      def initialize params
+        @age13_17female = params[:age13_17female]
+        @age55_64female = params[:age55_64female]
+        @age65_female = params[:age65_female]
+        @age25_34male = params[:age25_34male]
+        @age25_34female = params[:age25_34female]
+        @age55_64male = params[:age55_64male]
+        @age45_54female = params[:age45_54female]
+        @age35_44female = params[:age35_44female]
+        @age18_24female = params[:age18_24female]
+        @age65_male = params[:age65_male]
+        @age35_44male = params[:age35_44male]
+        @age45_54male = params[:age45_54male]
+        @age18_24male = params[:age18_24male]
+        @age13_17male = params[:age13_17male]
+      end
+
+      def self.female
+        return age13_17female + age18_24female + age25_34female + age35_44female + age45_54female + age55_64female + age65_female
+      end
+
+      def self.male
+        return age13_17male + age18_24male + age25_34male + age35_44male + age45_54male + age55_64male + age65_male
+      end
+
+      def self.age13_17
+        age13_17male + age13_17female
+      end
+
+      def self.age18_24
+        age18_24male + age18_24female
+      end
+
+      def self.age25_34
+        age25_34male + age25_34female
+      end
+
+      def self.age35_44
+        age35_44male + age35_44female
+      end
+
+      def self.age45_54
+        age45_54male + age45_54female
+      end
+
+      def self.age55_64
+        age55_64male + age55_64female
+      end
+
+      def self.age65
+        age65_male + age65_female
+      end
+    end
+  end
+end

data/lib/yt_analytics/model/watch_time_metrics.rb

@@ -0,0 +1,17 @@
+class YTAnalytics
+  module Model #:nodoc:
+    class WatchTimeMetrics #:nodoc:
+
+      include YTAnalytics::Logging
+      attr_accessor :end_date, :estimatedMinutesWatched, :averageViewDuration, :averageViewPercentage
+
+      def initialize params
+        @end_date = params[:endDate] if params[:endDate]
+        @estimatedMinutesWatched = params[:estimatedMinutesWatched] if params[:estimatedMinutesWatched]
+        @averageViewDuration = params[:averageViewDuration] if params[:averageViewDuration]
+        @averageViewPercentage = params[:averageViewPercentage] if params[:averageViewPercentage]
+      end
+      
+    end
+  end
+end

data/lib/yt_analytics/parser.rb

@@ -51,7 +51,7 @@ class YTAnalytics
 
             headers.each_with_index do |column,i|
               if column["columnType"] == "DIMENSION"
-                metrics[:endDate] = Date.strptime row[i], "%Y-%m-%d"
+                metrics[:endDate] = Date.strptime row[i], row[i].length  == 7 ? "%Y-%m" : "%Y-%m-%d"
               elsif column["columnType"] == "METRIC"
                 metrics[eval(":" + column["name"])] = row[i]
               end
@@ -65,6 +65,52 @@ class YTAnalytics
       end
     end
 
+    class DemographicParser < FeedParser
+
+    private
+      def parse_content(content)
+        temporal_metrics = []
+        if content.is_a? Hash and content["rows"].is_a? Array and content["rows"].length > 0
+          metrics = {}
+
+          content["rows"].each do |row|
+            metrics[eval(":" + row[0].to_s.underscore + row[1].to_s.underscore)] = row[2]
+          end
+        end
+        YouTubeIt::Request::DemographicMetrics.new(metrics)
+      end
+    end
+
+
+    class WatchTimeParser < FeedParser
+
+    private
+      def parse_content(content)
+        watch_time_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
+            watch_time_metrics.push(YTAnalytics::Model::WatchTimeMetrics.new(metrics))
+          end
+
+          watch_time_metrics.sort { |a,b| a.end_date <=> b.end_date }
+        end
+        watch_time_metrics
+      end
+    end
+
+
     class AnalyticsParser < FeedParser #:nodoc:
 
     private

data/lib/yt_analytics/request/authentication.rb

@@ -56,10 +56,20 @@ class YTAnalytics
 
       def temporal_totals(dimension, user_id, options)
         #dimension is either day, 7DayTotals, 30DayTotals, or month
-        
         opts = {'ids' => "channel==#{user_id}", 'dimensions' => dimension}
-        opts['start-date'] = (options['start-date'].strftime("%Y-%m-%d") if options['start-date']) || 1.day.ago.strftime("%Y-%m-%d")
-        opts['end-date'] = (options['end-date'].strftime("%Y-%m-%d") if options['end-date']) || 1.day.ago.strftime("%Y-%m-%d")
+
+        start_date = options['start-date'] || 2.days.ago
+        end_date = options['end-date'] || 2.days.ago
+
+        if (dimension == "month")
+          start_date = start_date.at_beginning_of_month
+          end_date = end_date.at_beginning_of_month
+        end
+
+        opts['start-date'] = start_date.strftime("%Y-%m-%d")
+        opts['end-date'] = end_date.strftime("%Y-%m-%d")
+        opts['filters'] = options['filters']
+
         if options['metrics'].class == Array
           opts['metrics'] = options['metrics'].join(",")
         elsif options['metrics'].class == String
@@ -75,6 +85,44 @@ class YTAnalytics
         return YTAnalytics::Parser::TemporalParser.new(content).parse
       end
 
+      def demographic_percentages(user_id, options)        
+        opts = {'ids' => "channel==#{user_id}", 'dimensions' => 'ageGroup,gender'}
+        opts['start-date'] = (options['start-date'].strftime("%Y-%m-%d") if options['start-date']) || 2.day.ago.strftime("%Y-%m-%d")
+        opts['end-date'] = (options['end-date'].strftime("%Y-%m-%d") if options['end-date']) || 2.day.ago.strftime("%Y-%m-%d")
+        if options['metrics'].class == Array
+          opts['metrics'] = options['metrics'].join(",")
+        elsif options['metrics'].class == String
+          opts['metrics'] = options['metrics'].delete(" ")
+        else
+          opts['metrics'] = 'viewerPercentage'
+        end
+        
+        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::DemographicParser.new(content).parse
+      end
+
+      def watch_time_metrics(dimension, user_id, options)
+        #dimension is day
+        opts = {'ids' => "channel==#{user_id}", 'dimensions' => dimension}
+        opts['start-date'] = (options['start-date'].strftime("%Y-%m-%d") if options['start-date']) || 1.day.ago.strftime("%Y-%m-%d")
+        opts['end-date'] = (options['end-date'].strftime("%Y-%m-%d") if options['end-date']) || 1.day.ago.strftime("%Y-%m-%d")
+        if options['metrics'].class == Array
+          opts['metrics'] = options['metrics'].join(",")
+        elsif options['metrics'].class == String
+          opts['metrics'] = options['metrics'].delete(" ")
+        else
+          opts['metrics'] = 'estimatedMinutesWatched,averageViewDuration,averageViewPercentage'
+        end
+        
+        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::WatchTimeParser.new(content).parse
+      end
 
       private
 

data/lib/yt_analytics/version.rb

@@ -1,4 +1,4 @@
 class YTAnalytics
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'
 end
 

data/lib/yt_analytics.rb

@@ -63,6 +63,8 @@ end
   client
   parser
   model/temporal_metrics
+  model/demographic_metrics
+  model/watch_time_metrics
   request/authentication
   middleware/faraday_authheader.rb
   middleware/faraday_oauth.rb

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yt_analytics
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-11 00:00:00.000000000 Z
+date: 2012-12-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -121,7 +121,9 @@ files:
 - 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/demographic_metrics.rb
 - lib/yt_analytics/model/temporal_metrics.rb
+- lib/yt_analytics/model/watch_time_metrics.rb
 - lib/yt_analytics/parser.rb
 - lib/yt_analytics/request/authentication.rb
 - lib/yt_analytics/version.rb