yt 0.27.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ae245f2241c225b65e4d6d45e98f9124afcca9a
-  data.tar.gz: 5712381f9ea126fe61729b21ed517a1bc9429b55
+  metadata.gz: a5e55e68762b528cbc7c42e4fe7e22adf9281696
+  data.tar.gz: 90ee508824b125d5c3870033530892cf55d0f333
 SHA512:
-  metadata.gz: 69b149b667c9f0684320faa6a45bd62e153cedd1b5d515c2e98f8dfe15b4286a7cda911cb2bc1eee8b5df2ed15ca7b8fad86b525b6f82d1e6a5a13c3a6df9bb4
-  data.tar.gz: a0701e11530ae0e98a02ef07de7b40be1f1647e557de920de265e21718a886541693f6e14b150d33754495743b2afcbd04fc6796ea960469f5ad4f2eac3e35c0
+  metadata.gz: da61fb4dcd83bd430f17be5c41d86fd77c943706ed515644ddefe633753f13d396bcf9c26805c95795881ea8e56fa87377fd41cb4fb9eacbbeaf0f9c46f36c3f
+  data.tar.gz: 4e640d95814a39547d4512ee9bdf5f96bc52370c3b0b70d41c8111f11326343464bf6d64087fed7b843406f5f7ef3d1836164a28241506a02b9eeee233c2b0ee

data/CHANGELOG.md

@@ -6,6 +6,18 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.28.0 - 2016-10-18
+
+**How to upgrade**
+
+If your code calls `.earnings` and `.impressions`
+then you must replace that code  with `.estimated_revenue` and
+`.ad_impressions` since those metrics will no longer be supported by
+YouTube API as of [November 4, 2016](https://developers.google.com/youtube/analytics/revision_history#august-10-2016).
+
+* [breaking change] Change deprecated `earnings` to `estimated_revenue`
+* [breaking change] Change deprecated `impressions` to `ad_impressions`
+
 ## 0.27.0 - 2016-10-07
 
 **How to upgrade**

data/lib/yt.rb

@@ -18,7 +18,7 @@ require 'yt/models/advertising_options_set'
 # An object-oriented Ruby client for YouTube.
 # Helps creating applications that need to interact with YouTube objects.
 # Inclused methods to access YouTube Data API V3 resources (channels, videos,
-# ...), YouTube Analytics API V2 resources (metrics, earnings, ...), and
+# ...), YouTube Analytics API V2 resources (metrics, estimated_revenue, ...), and
 # objects not available through the API (annotations).
 module Yt
 end

data/lib/yt/associations/has_reports.rb

@@ -299,11 +299,11 @@ module Yt
 
       def define_all_metric_method(metric, type)
         define_method "all_#{metric}" do
-          # @note Asking for the "earnings" metric of a day in which a channel
+          # @note Asking for the "estimated_revenue" metric of a day in which a channel
           # made 0 USD returns the wrong "nil". But adding to the request the
           # "estimatedMinutesWatched" metric returns the correct value 0.
           metrics = {metric => type}
-          metrics[:estimated_minutes_watched] = Integer if metric == :earnings
+          metrics[:estimated_minutes_watched] = Integer if metric == :estimated_revenue
           Collections::Reports.of(self).tap{|reports| reports.metrics = metrics}
         end
         private "all_#{metric}"

data/lib/yt/collections/reports.rb

@@ -136,7 +136,7 @@ module Yt
           elsif dimension.in? [:traffic_source, :country, :state, :playback_location, :device_type, :operating_system, :subscribed_status]
             hash = hash.transform_values{|h| h.sort_by{|range, v| -v}.to_h}
           end
-          (@metrics.one? || @metrics.keys == [:earnings, :estimated_minutes_watched]) ? hash[@metrics.keys.first] : hash
+          (@metrics.one? || @metrics.keys == [:estimated_revenue, :estimated_minutes_watched]) ? hash[@metrics.keys.first] : hash
         end
       # NOTE: Once in a while, YouTube responds with 400 Error and the message
       # "Invalid query. Query did not conform to the expectations."; in this
@@ -179,8 +179,8 @@ module Yt
           params['max-results'] = 50 if @dimension.in? [:playlist, :video]
           params['max-results'] = 25 if @dimension.in? [:embedded_player_location, :related_video, :search_term, :referrer]
           if @dimension.in? [:video, :playlist, :embedded_player_location, :related_video, :search_term, :referrer]
-            if @metrics.keys == [:earnings, :estimated_minutes_watched]
-              params['sort'] = '-earnings'
+            if @metrics.keys == [:estimated_revenue, :estimated_minutes_watched]
+              params['sort'] = '-estimatedRevenue'
             else
               params['sort'] = "-#{@metrics.keys.join(',').to_s.camelize(:lower)}"
             end

data/lib/yt/models/channel.rb

@@ -181,10 +181,10 @@ module Yt
       has_report :card_teaser_click_rate, Float
 
       # @macro report_by_day_and_country
-      has_report :earnings, Float
+      has_report :estimated_revenue, Float
 
       # @macro report_by_day_and_country
-      has_report :impressions, Integer
+      has_report :ad_impressions, Integer
 
       # @macro report_by_day_and_country
       has_report :monetized_playbacks, Integer

data/lib/yt/models/video.rb

@@ -464,10 +464,10 @@ module Yt
       has_report :card_teaser_click_rate, Float
 
       # @macro report_by_day_and_country
-      has_report :earnings, Float
+      has_report :estimated_revenue, Float
 
       # @macro report_by_day_and_country
-      has_report :impressions, Integer
+      has_report :ad_impressions, Integer
 
       # @macro report_by_day_and_country
       has_report :monetized_playbacks, Integer

data/lib/yt/models/video_group.rb

@@ -90,10 +90,10 @@ module Yt
       has_report :annotation_close_rate, Float
 
       # @macro report_by_day_and_country
-      has_report :earnings, Float
+      has_report :estimated_revenue, Float
 
       # @macro report_by_day_and_country
-      has_report :impressions, Integer
+      has_report :ad_impressions, Integer
 
       # @macro report_by_day_and_country
       has_report :monetized_playbacks, Integer

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.27.0'
+  VERSION = '0.28.0'
 end

data/spec/requests/as_account/channel_spec.rb

@@ -215,8 +215,8 @@ describe Yt::Channel, :device_app do
       expect{channel.card_teaser_clicks}.not_to raise_error
       expect{channel.card_teaser_click_rate}.not_to raise_error
       expect{channel.viewer_percentage}.not_to raise_error
-      expect{channel.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{channel.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{channel.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{channel.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{channel.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{channel.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
     end

data/spec/requests/as_account/video_spec.rb

@@ -305,8 +305,8 @@ describe Yt::Video, :device_app do
       expect{video.card_teaser_clicks}.not_to raise_error
       expect{video.card_teaser_click_rate}.not_to raise_error
       expect{video.viewer_percentage}.not_to raise_error
-      expect{video.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{video.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{video.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{video.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{video.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{video.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
       expect{video.advertising_options_set}.to raise_error Yt::Errors::Forbidden
@@ -710,8 +710,8 @@ describe Yt::Video, :device_app do
       expect{video.annotation_click_through_rate}.not_to raise_error
       expect{video.annotation_close_rate}.not_to raise_error
       expect{video.viewer_percentage}.not_to raise_error
-      expect{video.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{video.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{video.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{video.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{video.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{video.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
       expect{video.advertising_options_set}.to raise_error Yt::Errors::Forbidden
@@ -1096,8 +1096,8 @@ describe Yt::Video, :device_app do
       expect{video.annotation_click_through_rate}.not_to raise_error
       expect{video.annotation_close_rate}.not_to raise_error
       expect{video.viewer_percentage}.not_to raise_error
-      expect{video.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{video.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{video.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{video.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{video.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{video.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
       expect{video.advertising_options_set}.to raise_error Yt::Errors::Forbidden
@@ -1501,8 +1501,8 @@ describe Yt::Video, :device_app do
       expect{video.annotation_click_through_rate}.not_to raise_error
       expect{video.annotation_close_rate}.not_to raise_error
       expect{video.viewer_percentage}.not_to raise_error
-      expect{video.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{video.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{video.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{video.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{video.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{video.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
       expect{video.advertising_options_set}.to raise_error Yt::Errors::Forbidden
@@ -1906,8 +1906,8 @@ describe Yt::Video, :device_app do
       expect{video.annotation_click_through_rate}.not_to raise_error
       expect{video.annotation_close_rate}.not_to raise_error
       expect{video.viewer_percentage}.not_to raise_error
-      expect{video.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{video.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{video.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{video.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{video.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{video.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
       expect{video.advertising_options_set}.to raise_error Yt::Errors::Forbidden
@@ -2312,8 +2312,8 @@ describe Yt::Video, :device_app do
       expect{video.annotation_click_through_rate}.not_to raise_error
       expect{video.annotation_close_rate}.not_to raise_error
       expect{video.viewer_percentage}.not_to raise_error
-      expect{video.earnings}.to raise_error Yt::Errors::Unauthorized
-      expect{video.impressions}.to raise_error Yt::Errors::Unauthorized
+      expect{video.estimated_revenue}.to raise_error Yt::Errors::Unauthorized
+      expect{video.ad_impressions}.to raise_error Yt::Errors::Unauthorized
       expect{video.monetized_playbacks}.to raise_error Yt::Errors::Unauthorized
       expect{video.playback_based_cpm}.to raise_error Yt::Errors::Unauthorized
       expect{video.advertising_options_set}.to raise_error Yt::Errors::Forbidden

data/spec/requests/as_content_owner/channel_spec.rb

@@ -22,7 +22,7 @@ describe Yt::Channel, :partner do
           card_impressions: Integer, card_clicks: Integer,
           card_click_rate: Float, card_teaser_impressions: Integer,
           card_teaser_clicks: Integer, card_teaser_click_rate: Float,
-          earnings: Float, impressions: Integer,
+          estimated_revenue: Float, ad_impressions: Integer,
           monetized_playbacks: Integer, playback_based_cpm: Float}
         specify 'by day, and are chronologically sorted' do
           range = {since: 5.days.ago.to_date, until: 3.days.ago.to_date}
@@ -63,11 +63,11 @@ describe Yt::Channel, :partner do
        :subscribers_gained, :subscribers_lost,
        :videos_added_to_playlists, :videos_removed_from_playlists,
        :estimated_minutes_watched, :average_view_duration,
-       :average_view_percentage, :impressions, :monetized_playbacks,
+       :average_view_percentage, :ad_impressions, :monetized_playbacks,
        :annotation_clicks, :annotation_click_through_rate,
        :card_impressions, :card_clicks, :card_click_rate,
        :card_teaser_impressions, :card_teaser_clicks, :card_teaser_click_rate,
-       :playback_based_cpm, :annotation_close_rate, :earnings].each do |metric|
+       :playback_based_cpm, :annotation_close_rate, :estimated_revenue].each do |metric|
         describe "#{metric} can be retrieved for a range of days" do
           let(:date_in) { ENV['YT_TEST_PARTNER_VIDEO_DATE'] }
           let(:date_out) { Date.parse(ENV['YT_TEST_PARTNER_VIDEO_DATE']) + 5 }
@@ -126,10 +126,10 @@ describe Yt::Channel, :partner do
        card_click_rate: Float, card_teaser_impressions: Integer,
        card_teaser_clicks: Integer, card_teaser_click_rate: Float,
        videos_added_to_playlists: Integer, videos_removed_from_playlists: Integer,
-       average_view_percentage: Float, impressions: Integer,
+       average_view_percentage: Float, ad_impressions: Integer,
        shares: Integer, playback_based_cpm: Float,
        monetized_playbacks: Integer, annotation_close_rate: Float,
-       earnings: Float}.each do |metric, type|
+       estimated_revenue: Float}.each do |metric, type|
         describe "#{metric} can be grouped by range" do
           let(:metric) { metric }
 
@@ -151,24 +151,24 @@ describe Yt::Channel, :partner do
         end
       end
 
-      describe 'earnings can be retrieved for a specific day' do
+      describe 'estimated_revenue can be retrieved for a specific day' do
         # NOTE: This test sounds redundant, but it’s actually a reflection of
         # another irrational behavior of YouTube API. In short, if you ask for
-        # the "earnings" metric of a day in which a channel made 0 USD, then
-        # the API returns "nil". But if you also for the "earnings" metric AND
+        # the "estimated_revenue" metric of a day in which a channel made 0 USD, then
+        # the API returns "nil". But if you also for the "estimated_revenue" metric AND
         # the "estimatedMinutesWatched" metric, then the API returns the
         # correct value of "0", while still returning nil for those days in
-        # which the earnings have not been estimated yet.
+        # which the estimated_revenue have not been estimated yet.
         context 'in which the channel did not make any money' do
-          let(:zero_date) { ENV['YT_TEST_PARTNER_CHANNEL_NO_EARNINGS_DATE'] }
-          let(:earnings) { channel.earnings_on zero_date}
-          it { expect(earnings).to eq 0 }
+          let(:zero_date) { ENV['YT_TEST_PARTNER_CHANNEL_NO_estimated_revenue_DATE'] }
+          let(:estimated_revenue) { channel.estimated_revenue_on zero_date}
+          it { expect(estimated_revenue).to eq 0 }
         end
       end
 
-      describe 'earnings can be retrieved for a single country' do
+      describe 'estimated_revenue can be retrieved for a single country' do
         let(:country_code) { 'US' }
-        let(:earnings) { channel.earnings since: date, by: by, in: location }
+        let(:estimated_revenue) { channel.estimated_revenue since: date, by: by, in: location }
         let(:date) { 4.days.ago }
 
         context 'and grouped by day' do
@@ -176,12 +176,12 @@ describe Yt::Channel, :partner do
 
           context 'with the :in option set to the country code' do
             let(:location) { country_code }
-            it { expect(earnings.keys.min).to eq date.to_date }
+            it { expect(estimated_revenue.keys.min).to eq date.to_date }
           end
 
           context 'with the :in option set to {country: country code}' do
             let(:location) { {country: country_code} }
-            it { expect(earnings.keys.min).to eq date.to_date }
+            it { expect(estimated_revenue.keys.min).to eq date.to_date }
           end
         end
 
@@ -190,34 +190,34 @@ describe Yt::Channel, :partner do
 
           context 'with the :in option set to the country code' do
             let(:location) { country_code }
-            it { expect(earnings.keys).to eq [country_code] }
+            it { expect(estimated_revenue.keys).to eq [country_code] }
           end
 
           context 'with the :in option set to {country: country code}' do
             let(:location) { {country: country_code} }
-            it { expect(earnings.keys).to eq [country_code] }
+            it { expect(estimated_revenue.keys).to eq [country_code] }
           end
         end
       end
 
-      describe 'earnings can be grouped by day' do
+      describe 'estimated_revenue 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 'with the :by option set to :day' do
-          earnings = channel.earnings range.merge by: :day
-          expect(earnings.keys).to eq range.values
+          estimated_revenue = channel.estimated_revenue range.merge by: :day
+          expect(estimated_revenue.keys).to eq range.values
         end
       end
 
-      describe 'earnings can be grouped by country' do
+      describe 'estimated_revenue can be grouped by country' do
         let(:range) { {since: 4.days.ago, until: 3.days.ago} }
 
         specify 'with the :by option set to :country' do
-          earnings = channel.earnings range.merge by: :country
-          expect(earnings.keys).to all(be_a String)
-          expect(earnings.keys.map(&:length).uniq).to eq [2]
-          expect(earnings.values).to all(be_a Float)
+          estimated_revenue = channel.estimated_revenue range.merge by: :country
+          expect(estimated_revenue.keys).to all(be_a String)
+          expect(estimated_revenue.keys.map(&:length).uniq).to eq [2]
+          expect(estimated_revenue.values).to all(be_a Float)
         end
       end
 
@@ -1319,9 +1319,9 @@ describe Yt::Channel, :partner do
         end
       end
 
-      describe 'impressions can be retrieved for a single country' do
+      describe 'ad_impressions can be retrieved for a single country' do
         let(:country_code) { 'US' }
-        let(:impressions) { channel.impressions since: date, by: by, in: location }
+        let(:ad_impressions) { channel.ad_impressions since: date, by: by, in: location }
         let(:date) { ENV['YT_TEST_PARTNER_PLAYLIST_DATE'] }
 
         context 'and grouped by day' do
@@ -1329,12 +1329,12 @@ describe Yt::Channel, :partner do
 
           context 'with the :in option set to the country code' do
             let(:location) { country_code }
-            it { expect(impressions.keys.min).to eq date.to_date }
+            it { expect(ad_impressions.keys.min).to eq date.to_date }
           end
 
           context 'with the :in option set to {country: country code}' do
             let(:location) { {country: country_code} }
-            it { expect(impressions.keys.min).to eq date.to_date }
+            it { expect(ad_impressions.keys.min).to eq date.to_date }
           end
         end
 
@@ -1343,34 +1343,34 @@ describe Yt::Channel, :partner do
 
           context 'with the :in option set to the country code' do
             let(:location) { country_code }
-            it { expect(impressions.keys).to eq [country_code] }
+            it { expect(ad_impressions.keys).to eq [country_code] }
           end
 
           context 'with the :in option set to {country: country code}' do
             let(:location) { {country: country_code} }
-            it { expect(impressions.keys).to eq [country_code] }
+            it { expect(ad_impressions.keys).to eq [country_code] }
           end
         end
       end
 
-      describe 'impressions can be grouped by day' do
+      describe 'ad_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 'with the :by option set to :day' do
-          impressions = channel.impressions range.merge by: :day
-          expect(impressions.keys).to eq range.values
+          ad_impressions = channel.ad_impressions range.merge by: :day
+          expect(ad_impressions.keys).to eq range.values
         end
       end
 
-      describe 'impressions can be grouped by country' do
+      describe 'ad_impressions can be grouped by country' do
         let(:range) { {since: ENV['YT_TEST_PARTNER_PLAYLIST_DATE']} }
 
         specify 'with the :by option set to :country' do
-          impressions = channel.impressions range.merge by: :country
-          expect(impressions.keys).to all(be_a String)
-          expect(impressions.keys.map(&:length).uniq).to eq [2]
-          expect(impressions.values).to all(be_an Integer)
+          ad_impressions = channel.ad_impressions range.merge by: :country
+          expect(ad_impressions.keys).to all(be_a String)
+          expect(ad_impressions.keys.map(&:length).uniq).to eq [2]
+          expect(ad_impressions.values).to all(be_an Integer)
         end
       end
 
@@ -1872,8 +1872,8 @@ describe Yt::Channel, :partner do
     context 'not managed by the authenticated Content Owner' do
       let(:id) { 'UCBR8-60-B28hp2BmDPdntcQ' }
 
-      specify 'earnings and impressions cannot be retrieved' do
-        expect{channel.earnings}.to raise_error Yt::Errors::Forbidden
+      specify 'estimated_revenue and ad_impressions cannot be retrieved' do
+        expect{channel.estimated_revenue}.to raise_error Yt::Errors::Forbidden
         expect{channel.views}.to raise_error Yt::Errors::Forbidden
       end
 
@@ -1883,4 +1883,4 @@ describe Yt::Channel, :partner do
       end
     end
   end
-end
+end

data/spec/requests/as_content_owner/video_group_spec.rb

@@ -60,7 +60,7 @@ describe Yt::VideoGroup, :partner do
           average_view_duration: Integer,
           average_view_percentage: Float, annotation_clicks: Integer,
           annotation_click_through_rate: Float,
-          annotation_close_rate: Float, earnings: Float, impressions: Integer,
+          annotation_close_rate: Float, estimated_revenue: Float, ad_impressions: Integer,
           monetized_playbacks: Integer}
 
         specify 'by day, and are chronologically sorted' do

data/spec/requests/as_content_owner/video_spec.rb

@@ -17,11 +17,11 @@ describe Yt::Video, :partner do
        :subscribers_gained, :subscribers_lost,
        :videos_added_to_playlists, :videos_removed_from_playlists,
        :estimated_minutes_watched, :average_view_duration,
-       :average_view_percentage, :impressions, :monetized_playbacks,
+       :average_view_percentage, :ad_impressions, :monetized_playbacks,
        :annotation_clicks, :annotation_click_through_rate, :playback_based_cpm,
        :card_impressions, :card_clicks, :card_click_rate,
        :card_teaser_impressions, :card_teaser_clicks, :card_teaser_click_rate,
-       :annotation_close_rate, :earnings].each do |metric|
+       :annotation_close_rate, :estimated_revenue].each do |metric|
         describe "#{metric} can be retrieved for a range of days" do
           let(:date_in) { ENV['YT_TEST_PARTNER_VIDEO_DATE'] }
           let(:date_out) { Date.parse(ENV['YT_TEST_PARTNER_VIDEO_DATE']) + 5 }
@@ -94,13 +94,13 @@ describe Yt::Video, :partner do
        shares: Integer, subscribers_gained: Integer, subscribers_lost: Integer,
        videos_added_to_playlists: Integer, videos_removed_from_playlists: Integer,
        estimated_minutes_watched: Integer, average_view_duration: Integer,
-       average_view_percentage: Float, impressions: Integer,
+       average_view_percentage: Float, ad_impressions: Integer,
        monetized_playbacks: Integer, annotation_clicks: Integer,
        annotation_click_through_rate: Float, annotation_close_rate: Float,
        card_impressions: Integer, card_clicks: Integer,
        card_click_rate: Float, card_teaser_impressions: Integer,
        card_teaser_clicks: Integer, card_teaser_click_rate: Float,
-       earnings: Float}.each do |metric, type|
+       estimated_revenue: Float}.each do |metric, type|
         describe "#{metric} can be grouped by range" do
           let(:metric) { metric }
 
@@ -126,11 +126,11 @@ describe Yt::Video, :partner do
        :subscribers_gained, :subscribers_lost,
        :videos_added_to_playlists, :videos_removed_from_playlists,
        :estimated_minutes_watched, :average_view_duration,
-       :average_view_percentage, :impressions, :monetized_playbacks,
+       :average_view_percentage, :ad_impressions, :monetized_playbacks,
        :card_impressions, :card_clicks, :card_click_rate,
        :card_teaser_impressions, :card_teaser_clicks, :card_teaser_click_rate,
        :annotation_clicks, :annotation_click_through_rate,
-       :annotation_close_rate, :earnings].each do |metric|
+       :annotation_close_rate, :estimated_revenue].each do |metric|
         describe "#{metric} can be retrieved for a single country" do
           let(:result) { video.public_send metric, options }
 
@@ -185,7 +185,7 @@ describe Yt::Video, :partner do
           card_click_rate: Float, card_teaser_impressions: Integer,
           card_teaser_clicks: Integer, card_teaser_click_rate: Float,
           annotation_click_through_rate: Float,
-          annotation_close_rate: Float, earnings: Float, impressions: Integer,
+          annotation_close_rate: Float, estimated_revenue: Float, ad_impressions: Integer,
           monetized_playbacks: Integer}
 
         specify 'by day' do
@@ -222,24 +222,24 @@ describe Yt::Video, :partner do
         end
       end
 
-      describe 'earnings can be grouped by day' do
+      describe 'estimated_revenue 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 'with the :by option set to :day' do
-          earnings = video.earnings range.merge by: :day
-          expect(earnings.keys).to eq range.values
+          estimated_revenue = video.estimated_revenue range.merge by: :day
+          expect(estimated_revenue.keys).to eq range.values
         end
       end
 
-      describe 'earnings can be grouped by country' do
+      describe 'estimated_revenue can be grouped by country' do
         let(:range) { {since: 4.days.ago, until: 3.days.ago} }
 
         specify 'with the :by option set to :country' do
-          earnings = video.earnings range.merge by: :country
-          expect(earnings.keys).to all(be_a String)
-          expect(earnings.keys.map(&:length).uniq).to eq [2]
-          expect(earnings.values).to all(be_a Float)
+          estimated_revenue = video.estimated_revenue range.merge by: :country
+          expect(estimated_revenue.keys).to all(be_a String)
+          expect(estimated_revenue.keys.map(&:length).uniq).to eq [2]
+          expect(estimated_revenue.values).to all(be_a Float)
         end
       end
 
@@ -874,24 +874,24 @@ describe Yt::Video, :partner do
         end
       end
 
-      describe 'impressions can be grouped by day' do
+      describe 'ad_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 'with the :by option set to :day' do
-          impressions = video.impressions range.merge by: :day
-          expect(impressions.keys).to eq range.values
+          ad_impressions = video.ad_impressions range.merge by: :day
+          expect(ad_impressions.keys).to eq range.values
         end
       end
 
-      describe 'impressions can be grouped by country' do
+      describe 'ad_impressions can be grouped by country' do
         let(:range) { {since: ENV['YT_TEST_PARTNER_VIDEO_DATE']} }
 
         specify 'with the :by option set to :country' do
-          impressions = video.impressions range.merge by: :country
-          expect(impressions.keys).to all(be_a String)
-          expect(impressions.keys.map(&:length).uniq).to eq [2]
-          expect(impressions.values).to all(be_an Integer)
+          ad_impressions = video.ad_impressions range.merge by: :country
+          expect(ad_impressions.keys).to all(be_a String)
+          expect(ad_impressions.keys.map(&:length).uniq).to eq [2]
+          expect(ad_impressions.values).to all(be_an Integer)
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.27.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-10 00:00:00.000000000 Z
+date: 2016-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport