yt 0.26.2 → 0.26.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8b401e7fc1527689e8d57bba9adfb082bb1edad7
-  data.tar.gz: 05c8c0777af55da0d355ab056716ce471645db2d
+  metadata.gz: 9c8bd5aecd37bbb0c4209b5fa1b0c7b425610629
+  data.tar.gz: 008187e83de0b7e3da55e65b12ff42ccb3f1dd40
 SHA512:
-  metadata.gz: 1473ef3a2b7731419bd69879e944a8f997cdbda15c06180bf998b18b555f2d4561d30667df24f41078597ef3405897fd614c8489bf8330597cc34a2002d5c2b3
-  data.tar.gz: 8d822e0aec52874704030eea47e7fb23f21338df2792096167c27304c3b148ecf01ab0e9803faa2f783aea88bc3bb2b637d7fac7be24366b89c1555038d80bc4
+  metadata.gz: 558f54d0e5e96a1d8bdec7bd737c7fbd5b3706a675c04baf36176b100735f95633e6412a3fa1f445b2f0c7c713832dfc309a07a2cf112fccd0b0d94c84a9dc42
+  data.tar.gz: 45cd8bb547e80018da19faabfd2a89adfbcce1035382c1192d1cead129ab583f778e8e82a7c028b261db0c25d8091a270d4a4863e225719a5242c3717ccde812

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.26.3 - 2016-10-07
+
+* [FEATURE] Add `by: :subscribed_status` option for reports, to return views (from a `content_owner.video`) by subscribed status.
+* [FEATURE] Add `Yt::Collections::Reports::SUBSCRIBED_STATUSES` to list all subscribed statuses supported by YouTube Analytics API.
+
 ## 0.26.2 - 2016-10-05
 
 * [ENHANCEMENT] Add newly available traffic sources: "Campaign card" and "End screen"

data/lib/yt/collections/reports.rb

@@ -11,6 +11,7 @@ module Yt
         hash[:traffic_source] = {name: 'insightTrafficSourceType', parse: ->(source, *values) { @metrics.keys.zip(values.map{|v| {TRAFFIC_SOURCES.key(source) => v}}).to_h} }
         hash[:playback_location] = {name: 'insightPlaybackLocationType', parse: ->(location, *values) { @metrics.keys.zip(values.map{|v| {PLAYBACK_LOCATIONS.key(location) => v}}).to_h} }
         hash[:embedded_player_location] = {name: 'insightPlaybackLocationDetail', parse: ->(url, *values) {@metrics.keys.zip(values.map{|v| {url => v}}).to_h} }
+        hash[:subscribed_status] = {name: 'subscribedStatus', parse: ->(status, *values) {@metrics.keys.zip(values.map{|v| {SUBSCRIBED_STATUSES.key(status) => v}}).to_h} }
         hash[:related_video] = {name: 'insightTrafficSourceDetail', parse: ->(video_id, *values) { @metrics.keys.zip(values.map{|v| {video_id => v}}).to_h} }
         hash[:search_term] = {name: 'insightTrafficSourceDetail', parse: ->(search_term, *values) {@metrics.keys.zip(values.map{|v| {search_term => v}}).to_h} }
         hash[:referrer] = {name: 'insightTrafficSourceDetail', parse: ->(url, *values) {@metrics.keys.zip(values.map{|v| {url => v}}).to_h} }
@@ -61,6 +62,12 @@ module Yt
         mobile: 'MOBILE' # only present for data < September 10, 2013
       }
 
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Detail_Dimensions
+      SUBSCRIBED_STATUSES = {
+        subscribed: 'SUBSCRIBED',
+        unsubscribed: 'UNSUBSCRIBED'
+      }
+
       # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Device_Dimensions
       DEVICE_TYPES = {
         desktop: 'DESKTOP',
@@ -126,7 +133,7 @@ module Yt
             end
           elsif dimension == :day
             hash = hash.transform_values{|h| h.sort_by{|day, v| day}.to_h}
-          elsif dimension.in? [:traffic_source, :country, :state, :playback_location, :device_type, :operating_system]
+          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

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.26.2'
+  VERSION = '0.26.3'
 end

data/spec/requests/as_content_owner/video_spec.rb

@@ -422,6 +422,17 @@ describe Yt::Video, :partner do
         end
       end
 
+      describe 'views can be grouped by subscribed statuses' do
+        let(:range) { {since: ENV['YT_TEST_PARTNER_VIDEO_DATE']} }
+        let(:keys) { Yt::Collections::Reports::SUBSCRIBED_STATUSES.keys }
+
+        specify 'with the :by option set to subscribed statuses' do
+          views = video.views range.merge by: :subscribed_status
+          expect(views.keys - keys).to be_empty
+          expect(views.values).to all(be_an Integer)
+        end
+      end
+
       describe 'uniques can be retrieved for a single US state' do
         let(:state_code) { 'NY' }
         let(:result) { video.uniques since: date, by: by, in: location }

metadata

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