yt 0.13.12 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 61bf48f535309263dd745a133cb3d41c05eb93a2
-  data.tar.gz: 63bc4f48576730c827894c59b5884067dcac9295
+  metadata.gz: 4e12f9ef5c2b615833df8d63a3a821aadd397a3b
+  data.tar.gz: e79d293fdbaaeaf10c2c6bc5fc594363e31909a2
 SHA512:
-  metadata.gz: b627fd0536a0c09944fb73766d272a7c961dc271cc42aad92cd0a8748a33085e8f52aa5b54d096bdd39e0920ee59d77930b8c311b84aa53ff0c0a8b8961db7e1
-  data.tar.gz: a27c7014ed9d101d8305456edf31764145827b680cfabcc00c8841451fe73240e77d2e0160ba25342575d87ef88c6126a2b337f1de69c3b49812b451d5bffa4b
+  metadata.gz: 8c2d5f5ff6825b5f844903ffec97c794c40b75d44489736b9ba8116d838adceadff3fff0fad0d8f641937c76c27476ed5e322f5e232119483d486420bb60e3c4
+  data.tar.gz: d44fc9bcb26d18178da67a651419ca69e3be7bce825cedfc68b22dc2b996b84728b9cf483e152da2947db6a2c4b6ce1691201b443a2675d7bdd6bac2cfad6d6a

data/CHANGELOG.md

@@ -6,6 +6,11 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.14.0 - 2015-03-25
+
+* [FEATURE] New `by: :traffic_source` option for reports, to return views (channels/videos) and estimated watched minutes (channels) by traffic source.
+* [FEATURE] New `by: :video` option for reports, to return views and estimated watched minutes (channels) by video.
+
 ## 0.13.12 - 2015-03-23
 
 * [FEATURE] New channel/video reports: `favorites_added`, `favorites_removed`.

data/Gemfile

@@ -1,4 +1,6 @@
 source 'https://rubygems.org'
+gem 'pry'
+gem 'pry-nav'
 
 # Specify your gem's dependencies in yt.gemspec
 gemspec

data/README.md

@@ -148,7 +148,8 @@ Use [Yt::Channel](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Chan
 * access the channels that the channel is subscribed to
 * subscribe to and unsubscribe from a channel
 * delete playlists from a channel
-* retrieve the daily earnings, views, comments, likes, dislikes, shares, subscribers gained/lost, estimated/average video watch and impressions of a channel
+* retrieve the daily earnings, views, comments, likes, dislikes, shares, subscribers gained/lost, estimated/average video watch and impressions of a channel by day
+* retrieve the views and estimated minutes watched by traffic source
 * retrieve the viewer percentage of a channel by gender and age group
 
 ```ruby
@@ -210,6 +211,9 @@ channel.average_view_duration #=>  {Sun, 22 Feb 2015=>329.0, Mon, 23 Feb 2015=>3
 channel.average_view_percentage # {Sun, 22 Feb 2015=>38.858253094977265, Mon, 23 Feb 2015=>37.40014235438217, …}
 channel.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
 channel.viewer_percentage(gender: :male) #=> 49.12
+
+channel.views since: 7.days.ago, by: :traffic_source #=> {advertising: 10.0, related_video: 20.0, promoted: 5.0, subscriber: 1.0, channel: 3.0, other: 7.0}
+channel.estimated_minutes_watched since: 7.days.ago, by: :traffic_source #=> {annotation: 10.0, external_app: 20.0, external_url: 5.0, embedded: 1.0, search: 3.0}
 ```
 
 *The methods above require to be authenticated as the channel’s account (see below).*
@@ -232,6 +236,8 @@ channel.average_view_duration #=>  {Sun, 22 Feb 2015=>329.0, Mon, 23 Feb 2015=>3
 channel.average_view_percentage # {Sun, 22 Feb 2015=>38.858253094977265, Mon, 23 Feb 2015=>37.40014235438217, …}
 channel.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
 channel.viewer_percentage(gender: :female) #=> 49.12
+channel.views since: 7.days.ago, by: :traffic_source #=> {advertising: 10.0, related_video: 20.0, promoted: 5.0, subscriber: 1.0, channel: 3.0, other: 7.0}
+channel.estimated_minutes_watched since: 7.days.ago, by: :traffic_source #=> {annotation: 10.0, external_app: 20.0, external_url: 5.0, embedded: 1.0, search: 3.0}
 
 channel.content_owner #=> 'CMSname'
 channel.linked_at #=> Wed, 28 May 2014
@@ -250,7 +256,8 @@ Use [Yt::Video](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Video)
 * access the annotations of a video
 * delete a video
 * like and dislike a video
-* retrieve the daily earnings, views, comments, likes, dislikes, shares, subscribers gained/lost, impressions and monetized playbacks of a video
+* retrieve the daily earnings, views, comments, likes, dislikes, shares, subscribers gained/lost, impressions and monetized playbacks of a video by day
+* retrieve the views of a video by traffic source
 * retrieve the viewer percentage of a video by gender and age group
 * retrieve data about live-streaming videos
 * retrieve the advertising options of a video
@@ -346,6 +353,8 @@ video.subscribers_lost from: '2014-08-30', to: '2014-08-31' #=> {Sat, 30 Aug 201
 video.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
 video.viewer_percentage(gender: :female) #=> 49.12
 
+video.views since: 7.days.ago, by: :traffic_source #=> {advertising: 10.0, related_video: 20.0, promoted: 5.0, subscriber: 1.0, channel: 3.0, other: 7.0}
+
 video.delete #=> true
 ```
 
@@ -369,6 +378,8 @@ video.monetized_playbacks_on 5.days.ago #=> 123.0
 video.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
 video.viewer_percentage(gender: :female) #=> 49.12
 
+video.views since: 7.days.ago, by: :traffic_source #=> {advertising: 10.0, related_video: 20.0, promoted: 5.0, subscriber: 1.0, channel: 3.0, other: 7.0}
+
 video.ad_formats #=> ["standard_instream", "trueview_instream"]
 ```
 

data/lib/yt/associations/has_reports.rb

@@ -46,21 +46,27 @@ module Yt
           from = options[:since] || options[:from] || 5.days.ago
           to = options[:until] || options[:to] || 1.day.ago
           range = Range.new *[from, to].map(&:to_date)
+          dimension = options[:by] || :day
 
-          ivar = instance_variable_get "@#{metric}"
-          instance_variable_set "@#{metric}", ivar || {}
+          ivar = instance_variable_get "@#{metric}_#{dimension}"
+          instance_variable_set "@#{metric}_#{dimension}", ivar || {}
 
-          Hash[*range.flat_map do |date|
-            [date, instance_variable_get("@#{metric}")[date] ||= send("range_#{metric}", range)[date]]
-          end]
+          case dimension
+          when :day
+            Hash[*range.flat_map do |date|
+              [date, instance_variable_get("@#{metric}_#{dimension}")[date] ||= send("range_#{metric}", range, dimension)[date]]
+            end]
+          else
+            instance_variable_get("@#{metric}_#{dimension}")[range] ||= send("range_#{metric}", range, dimension)
+          end
         end
       end
 
       def define_range_metric_method(metric)
-        define_method "range_#{metric}" do |date_range|
-          ivar = instance_variable_get "@range_#{metric}"
-          instance_variable_set "@range_#{metric}", ivar || {}
-          instance_variable_get("@range_#{metric}")[date_range] ||= send("all_#{metric}").within date_range
+        define_method "range_#{metric}" do |date_range, dimension|
+          ivar = instance_variable_get "@range_#{metric}_#{dimension}"
+          instance_variable_set "@range_#{metric}_#{dimension}", ivar || {}
+          instance_variable_get("@range_#{metric}_#{dimension}")[date_range] ||= send("all_#{metric}").within date_range, dimension
         end
         private "range_#{metric}"
       end

data/lib/yt/collections/reports.rb

@@ -3,10 +3,34 @@ require 'yt/collections/base'
 module Yt
   module Collections
     class Reports < Base
+      DIMENSIONS = Hash.new({name: 'day', parse: -> (day) {Date.iso8601 day} }).tap do |hash|
+        hash[:traffic_source] = {name: 'insightTrafficSourceType', parse: -> (type) {TRAFFIC_SOURCES.key type} }
+        hash[:video] = {name: 'video', parse: -> (video_id) { Yt::Video.new id: video_id, auth: @auth } }
+      end
+
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Traffic_Source_Dimensions
+      # @note EXT_APP is also returned but it’s not in the documentation above!
+      TRAFFIC_SOURCES = {
+        advertising: 'ADVERTISING',
+        annotation: 'ANNOTATION',
+        external_app: 'EXT_APP',
+        external_url: 'EXT_URL',
+        embedded: 'NO_LINK_EMBEDDED',
+        other: 'NO_LINK_OTHER',
+        playlist: 'PLAYLIST',
+        promoted: 'PROMOTED',
+        related_video: 'RELATED_VIDEO',
+        subscriber: 'SUBSCRIBER',
+        channel: 'YT_CHANNEL',
+        other_page: 'YT_OTHER_PAGE',
+        search: 'YT_SEARCH',
+      }
+
       attr_writer :metric
 
-      def within(days_range, try_again = true)
+      def within(days_range, dimension, try_again = true)
         @days_range = days_range
+        @dimension = dimension
         Hash[*flat_map{|daily_value| daily_value}]
       # NOTE: Once in a while, YouTube responds with 400 Error and the message
       # "Invalid query. Query did not conform to the expectations."; in this
@@ -15,13 +39,13 @@ module Yt
       # same query is a workaround that works and can hardly cause any damage.
       # Similarly, once in while YouTube responds with a random 503 error.
       rescue Yt::Error => e
-        try_again && rescue?(e) ? sleep(3) && within(days_range, false) : raise
+        try_again && rescue?(e) ? sleep(3) && within(days_range, dimension, false) : raise
       end
 
     private
 
       def new_item(data)
-        [day_of(data), value_of(data)]
+        [instance_exec(data.first, &DIMENSIONS[@dimension][:parse]), data.last]
       end
 
       # @see https://developers.google.com/youtube/analytics/v1/content_owner_reports
@@ -38,20 +62,12 @@ module Yt
           params['start-date'] = @days_range.begin
           params['end-date'] = @days_range.end
           params['metrics'] = @metric.to_s.camelize(:lower)
-          params['dimensions'] = :day
+          params['dimensions'] = DIMENSIONS[@dimension][:name]
+          params['max-results'] = 10 if @dimension == :video
+          params['sort'] = "-#{@metric.to_s.camelize(:lower)}" if @dimension == :video
         end
       end
 
-      def day_of(data)
-        # NOTE: could use column headers to be more precise
-        Date.iso8601 data.first
-      end
-
-      def value_of(data)
-        # NOTE: could use column headers to be more precise
-        data.last
-      end
-
       def items_key
         'rows'
       end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.13.12'
+  VERSION = '0.14.0'
 end

data/spec/requests/as_content_owner/channel_spec.rb

@@ -86,6 +86,40 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'views can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          views = channel.views range
+          expect(views.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          views = channel.views range.merge by: :day
+          expect(views.keys).to eq range.values
+        end
+      end
+
+      describe 'views can be grouped by traffic source' do
+        let(:range) { {since: 4.days.ago, until: 3.days.ago} }
+        let(:keys) { Yt::Collections::Reports::TRAFFIC_SOURCES.keys }
+
+        specify 'with the :by option set to :traffic_source' do
+          views = channel.views range.merge by: :traffic_source
+          expect(views.keys - keys).to be_empty
+        end
+      end
+
+      describe 'views can be grouped by video' do
+        let(:range) { {since: 4.days.ago, until: 3.days.ago} }
+
+        specify 'with the :by option set to :video' do
+          views = channel.views range.merge by: :video
+          expect(views.keys).to all(be_instance_of Yt::Video)
+        end
+      end
+
       describe 'comments can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:comments) { channel.comments_on 5.days.ago}
@@ -118,6 +152,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'comments can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          comments = channel.comments range
+          expect(comments.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          comments = channel.comments range.merge by: :day
+          expect(comments.keys).to eq range.values
+        end
+      end
+
       describe 'likes can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:likes) { channel.likes_on 5.days.ago}
@@ -150,6 +199,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'likes can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          likes = channel.likes range
+          expect(likes.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          likes = channel.likes range.merge by: :day
+          expect(likes.keys).to eq range.values
+        end
+      end
+
       describe 'dislikes can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:dislikes) { channel.dislikes_on 5.days.ago}
@@ -182,6 +246,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'dislikes can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          dislikes = channel.dislikes range
+          expect(dislikes.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          dislikes = channel.dislikes range.merge by: :day
+          expect(dislikes.keys).to eq range.values
+        end
+      end
+
       describe 'shares can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:shares) { channel.shares_on 5.days.ago}
@@ -214,6 +293,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'shares can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          shares = channel.shares range
+          expect(shares.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          shares = channel.shares range.merge by: :day
+          expect(shares.keys).to eq range.values
+        end
+      end
+
       describe 'gained subscribers can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:subscribers_gained) { channel.subscribers_gained_on 5.days.ago}
@@ -246,6 +340,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'gained subscribers can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          subscribers_gained = channel.subscribers_gained range
+          expect(subscribers_gained.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          subscribers_gained = channel.subscribers_gained range.merge by: :day
+          expect(subscribers_gained.keys).to eq range.values
+        end
+      end
+
       describe 'lost subscribers can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:subscribers_lost) { channel.subscribers_lost_on 5.days.ago}
@@ -278,6 +387,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'lost subscribers can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          subscribers_lost = channel.subscribers_lost range
+          expect(subscribers_lost.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          subscribers_lost = channel.subscribers_lost range.merge by: :day
+          expect(subscribers_lost.keys).to eq range.values
+        end
+      end
+
       describe 'added favorites can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:favorites_added) { channel.favorites_added_on 5.days.ago}
@@ -310,6 +434,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'added favorites can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          favorites_added = channel.favorites_added range
+          expect(favorites_added.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          favorites_added = channel.favorites_added range.merge by: :day
+          expect(favorites_added.keys).to eq range.values
+        end
+      end
+
       describe 'removed favorites can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:favorites_removed) { channel.favorites_removed_on 5.days.ago}
@@ -342,6 +481,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'removed favorites can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          favorites_removed = channel.favorites_removed range
+          expect(favorites_removed.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          favorites_removed = channel.favorites_removed range.merge by: :day
+          expect(favorites_removed.keys).to eq range.values
+        end
+      end
+
       describe 'estimated minutes watched can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:estimated_minutes_watched) { channel.estimated_minutes_watched_on 5.days.ago}
@@ -374,6 +528,40 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'estimated minutes watched can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          estimated_minutes_watched = channel.estimated_minutes_watched range
+          expect(estimated_minutes_watched.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          estimated_minutes_watched = channel.estimated_minutes_watched range.merge by: :day
+          expect(estimated_minutes_watched.keys).to eq range.values
+        end
+      end
+
+      describe 'estimated minutes watched can be grouped by traffic source' do
+        let(:range) { {since: 4.days.ago, until: 3.days.ago} }
+        let(:keys) { Yt::Collections::Reports::TRAFFIC_SOURCES.keys }
+
+        specify 'with the :by option set to :traffic_source' do
+          estimated_minutes_watched = channel.estimated_minutes_watched range.merge by: :traffic_source
+          expect(estimated_minutes_watched.keys - keys).to be_empty
+        end
+      end
+
+      describe 'estimated minutes watched can be grouped by video' do
+        let(:range) { {since: 4.days.ago, until: 3.days.ago} }
+
+        specify 'with the :by option set to :video' do
+          estimated_minutes_watched = channel.estimated_minutes_watched range.merge by: :video
+          expect(estimated_minutes_watched.keys).to all(be_instance_of Yt::Video)
+        end
+      end
+
       describe 'average view duration can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:average_view_duration) { channel.average_view_duration_on 5.days.ago}
@@ -406,6 +594,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'average view duration can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          average_view_duration = channel.average_view_duration range
+          expect(average_view_duration.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          average_view_duration = channel.average_view_duration range.merge by: :day
+          expect(average_view_duration.keys).to eq range.values
+        end
+      end
+
       describe 'average view percentage can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:average_view_percentage) { channel.average_view_percentage_on 5.days.ago}
@@ -438,6 +641,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'average view percentage can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          average_view_percentage = channel.average_view_percentage range
+          expect(average_view_percentage.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          average_view_percentage = channel.average_view_percentage range.merge by: :day
+          expect(average_view_percentage.keys).to eq range.values
+        end
+      end
+
       describe 'impressions can be retrieved for a specific day' do
         context 'in which the channel was partnered' do
           let(:impressions) { channel.impressions_on 20.days.ago}
@@ -470,6 +688,21 @@ describe Yt::Channel, :partner do
         end
       end
 
+      describe 'impressions can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          impressions = channel.impressions range
+          expect(impressions.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          impressions = channel.impressions range.merge by: :day
+          expect(impressions.keys).to eq range.values
+        end
+      end
+
       specify 'viewer percentages by gender and age range can be retrieved' do
         expect(channel.viewer_percentages[:female]['18-24']).to be_a Float
         expect(channel.viewer_percentages[:female]['25-34']).to be_a Float

data/spec/requests/as_content_owner/video_spec.rb

@@ -77,6 +77,31 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'views can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          views = video.views range
+          expect(views.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          views = video.views range.merge by: :day
+          expect(views.keys).to eq range.values
+        end
+      end
+
+      describe 'views can be grouped by traffic source' do
+        let(:range) { {since: 4.days.ago, until: 3.days.ago} }
+        let(:keys) { Yt::Collections::Reports::TRAFFIC_SOURCES.keys }
+
+        specify 'with the :by option set to :traffic_source' do
+          views = video.views range.merge by: :traffic_source
+          expect(views.keys - keys).to be_empty
+        end
+      end
+
       describe 'comments can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:comments) { video.comments_on 5.days.ago}
@@ -109,6 +134,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'comments can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          comments = video.comments range
+          expect(comments.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          comments = video.comments range.merge by: :day
+          expect(comments.keys).to eq range.values
+        end
+      end
+
       describe 'likes can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:likes) { video.likes_on 5.days.ago}
@@ -141,6 +181,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'likes can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          likes = video.likes range
+          expect(likes.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          likes = video.likes range.merge by: :day
+          expect(likes.keys).to eq range.values
+        end
+      end
+
       describe 'dislikes can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:dislikes) { video.dislikes_on 5.days.ago}
@@ -173,6 +228,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'dislikes can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          dislikes = video.dislikes range
+          expect(dislikes.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          dislikes = video.dislikes range.merge by: :day
+          expect(dislikes.keys).to eq range.values
+        end
+      end
+
       describe 'shares can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:shares) { video.shares_on 5.days.ago}
@@ -205,6 +275,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'shares can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          shares = video.shares range
+          expect(shares.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          shares = video.shares range.merge by: :day
+          expect(shares.keys).to eq range.values
+        end
+      end
+
       describe 'gained subscribers can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:subscribers_gained) { video.subscribers_gained_on 5.days.ago}
@@ -237,6 +322,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'gained subscribers can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          subscribers_gained = video.subscribers_gained range
+          expect(subscribers_gained.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          subscribers_gained = video.subscribers_gained range.merge by: :day
+          expect(subscribers_gained.keys).to eq range.values
+        end
+      end
+
       describe 'lost subscribers can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:subscribers_lost) { video.subscribers_lost_on 5.days.ago}
@@ -269,6 +369,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'lost subscribers can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          subscribers_lost = video.subscribers_lost range
+          expect(subscribers_lost.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          subscribers_lost = video.subscribers_lost range.merge by: :day
+          expect(subscribers_lost.keys).to eq range.values
+        end
+      end
+
       describe 'added favorites can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:favorites_added) { video.favorites_added_on 5.days.ago}
@@ -301,6 +416,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'added favorites can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          favorites_added = video.favorites_added range
+          expect(favorites_added.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          favorites_added = video.favorites_added range.merge by: :day
+          expect(favorites_added.keys).to eq range.values
+        end
+      end
+
       describe 'removed favorites can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:favorites_removed) { video.favorites_removed_on 5.days.ago}
@@ -333,6 +463,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'removed favorites can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          favorites_removed = video.favorites_removed range
+          expect(favorites_removed.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          favorites_removed = video.favorites_removed range.merge by: :day
+          expect(favorites_removed.keys).to eq range.values
+        end
+      end
+
       describe 'impressions can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:impressions) { video.impressions_on 20.days.ago}
@@ -365,6 +510,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'impressions can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          impressions = video.impressions range
+          expect(impressions.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          impressions = video.impressions range.merge by: :day
+          expect(impressions.keys).to eq range.values
+        end
+      end
+
       describe 'monetized playbacks can be retrieved for a specific day' do
         context 'in which the video was partnered' do
           let(:monetized_playbacks) { video.monetized_playbacks_on 20.days.ago}
@@ -397,6 +557,21 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'monetized_playbacks can be grouped by day' do
+        let(:range) { {since: 4.days.ago.to_date, until: 3.days.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'without a :by option (default)' do
+          monetized_playbacks = video.monetized_playbacks range
+          expect(monetized_playbacks.keys).to eq range.values
+        end
+
+        specify 'with the :by option set to :day' do
+          monetized_playbacks = video.monetized_playbacks range.merge by: :day
+          expect(monetized_playbacks.keys).to eq range.values
+        end
+      end
+
       specify 'viewer percentages by gender and age range can be retrieved' do
         expect(video.viewer_percentages[:female]['18-24']).to be_a Float
         expect(video.viewer_percentages[:female]['25-34']).to be_a Float

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.13.12
+  version: 0.14.0
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-24 00:00:00.000000000 Z
+date: 2015-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport