yt 0.25.38 → 0.25.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a809cd45081099159938ad218fa9145eec0216e9
-  data.tar.gz: 79ad8ab4601617c8ff5ba0d811914925d1b0f065
+  metadata.gz: b701173881774d821857b69ea48b6d4ac68e2ecc
+  data.tar.gz: be5e5d66828e51030cb4404a10c959a0273cda54
 SHA512:
-  metadata.gz: 752171b7409bcade5b5669514cf95bcb176cfbe32a80b6414b55b6ad5b7e4070129c73aecc621671aa1ad3db97fae9e1c1bed94e8f026ccd7d3f155ebc103cd8
-  data.tar.gz: ba17ce8ab592ae1cbb10ddfa68aee6ed17261dc60a313b7dfd55f1d867b1a97b7a2aeaa7c511e925e2e95ba1247f9b14e7b9f2aee584b3d6ec643fad9ccacddd
+  metadata.gz: aa7e8bef3a6345f5f6797c751bdedfa6b130b27ca1d93b3f5b73ed6cec9cb9252e07b4c96608a3ea0227d42e87a7b507593621594de2a8c7864a0ecbfc45c73d
+  data.tar.gz: b9e45f9d86ccec67cce14894b3f2c22587241951048d2710f75dbeb9115cf64040ee25d77ef2b30952cbbe21a15bc449355b2245d24899300a14779e54a20b76

data/CHANGELOG.md

@@ -6,6 +6,12 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.25.39 - 2016-06-15
+
+* [FEATURE] Add `by: :operating_system` option for reports, to return views (from a `content_owner.video`) by operating system.
+* [FEATURE] Add `Yt::Collections::Reports::DEVICE_TYPES` to list all device types supported by YouTube Analytics API.
+* [FEATURE] Add `Yt::Collections::Reports::OPERATING_SYSTEMS` to list all operating systems supported by YouTube Analytics API.
+
 ## 0.25.38 - 2016-06-13
 
 * [IMPROVEMENT] Don’t combine forContentOwner and publishedBefore parameters in Search#list since YouTube does not support this anymore.

data/lib/yt/collections/reports.rb

@@ -16,7 +16,8 @@ module Yt
         hash[:referrer] = {name: 'insightTrafficSourceDetail', parse: ->(url, *values) {@metrics.keys.zip(values.map{|v| {url => v}}).to_h} }
         hash[:video] = {name: 'video', parse: ->(video_id, *values) { @metrics.keys.zip(values.map{|v| {video_id => v}}).to_h} }
         hash[:playlist] = {name: 'playlist', parse: ->(playlist_id, *values) { @metrics.keys.zip(values.map{|v| {playlist_id => v}}).to_h} }
-        hash[:device_type] = {name: 'deviceType', parse: ->(type, *values) {@metrics.keys.zip(values.map{|v| {type.downcase.to_sym => v}}).to_h} }
+        hash[:device_type] = {name: 'deviceType', parse: ->(type, *values) {@metrics.keys.zip(values.map{|v| {DEVICE_TYPES.key(type) => v}}).to_h} }
+        hash[:operating_system] = {name: 'operatingSystem', parse: ->(os, *values) {@metrics.keys.zip(values.map{|v| {OPERATING_SYSTEMS.key(os) => v}}).to_h} }
         hash[:country] = {name: 'country', parse: ->(country_code, *values) { @metrics.keys.zip(values.map{|v| {country_code => v}}).to_h} }
         hash[:state] = {name: 'province', parse: ->(country_and_state_code, *values) { @metrics.keys.zip(values.map{|v| {country_and_state_code[3..-1] => v}}).to_h} }
         hash[:gender_age_group] = {name: 'gender,ageGroup', parse: ->(gender, *values) { [gender.downcase.to_sym, *values] }}
@@ -58,6 +59,41 @@ module Yt
         mobile: 'MOBILE' # only present for data < September 10, 2013
       }
 
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Device_Dimensions
+      DEVICE_TYPES = {
+        desktop: 'DESKTOP',
+        game_console: 'GAME_CONSOLE',
+        mobile: 'MOBILE',
+        tablet: 'TABLET',
+        tv: 'TV',
+        unknown_platform: 'UNKNOWN_PLATFORM'
+      }
+
+      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Device_Dimensions
+      OPERATING_SYSTEMS = {
+        android: 'ANDROID',
+        bada: 'BADA',
+        blackberry: 'BLACKBERRY',
+        chromecast: 'CHROMECAST',
+        docomo: 'DOCOMO',
+        hiptop: 'HIPTOP',
+        ios: 'IOS',
+        linux: 'LINUX',
+        macintosh: 'MACINTOSH',
+        meego: 'MEEGO',
+        nintendo_3ds: 'NINTENDO_3DS',
+        other: 'OTHER',
+        playstation: 'PLAYSTATION',
+        playstation_vita: 'PLAYSTATION_VITA',
+        smart_tv: 'SMART_TV',
+        symbian: 'SYMBIAN',
+        webos: 'WEBOS',
+        wii: 'WII',
+        windows: 'WINDOWS',
+        windows_mobile: 'WINDOWS_MOBILE',
+        xbox: 'XBOX'
+      }
+
       attr_writer :metrics
 
       def within(days_range, country, state, dimension, videos, try_again = true)
@@ -88,7 +124,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]
+          elsif dimension.in? [:traffic_source, :country, :state, :playback_location, :device_type, :operating_system]
             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.25.38'
+  VERSION = '0.25.39'
 end

data/spec/requests/as_content_owner/video_spec.rb

@@ -383,10 +383,21 @@ describe Yt::Video, :partner do
 
       describe 'views can be grouped by device type' do
         let(:range) { {since: ENV['YT_TEST_PARTNER_VIDEO_DATE']} }
+        let(:keys) { Yt::Collections::Reports::DEVICE_TYPES.keys }
 
         specify 'with the :by option set to :device_type' do
           views = video.views range.merge by: :device_type
-          expect(views.keys).to all(be_instance_of Symbol)
+          expect(views.keys - keys).to be_empty
+          expect(views.values).to all(be_an Integer)
+        end
+      end
+
+      describe 'views can be grouped by operating system' do
+        let(:keys) { Yt::Collections::Reports::OPERATING_SYSTEMS.keys }
+
+        specify 'with the :by option set to :operating_system' do
+          views = video.views by: :operating_system
+          expect(views.keys - keys).to be_empty
           expect(views.values).to all(be_an Integer)
         end
       end
@@ -1282,4 +1293,4 @@ describe Yt::Video, :partner do
       end
     end
   end
-end
+end

metadata

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