yt 0.25.17 → 0.25.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4740a6f0d76647ecc9d2fc04ed46fb6386a5c31d
-  data.tar.gz: f2b37bb5f0b81f4bd597079d75342d35d665871e
+  metadata.gz: 326f3adf4a4e1e7bbf64930125f77a404276d391
+  data.tar.gz: 26c77d99c92fc26b67b085bb1a453dc297f95a90
 SHA512:
-  metadata.gz: eba0b93123998b7a17377f6f3353c00da95ac0c8738d5f8319ae04fa74d1a6b54ad7fcae361dc893fe2c7537a298311859105a8cc08ba8ec89e250e6010610df
-  data.tar.gz: 87e76462320bedeee2e77d82071cad3c40ff0793963805797561e24737018f416f74b6f75fd5fe795cf8b9ebff42ad71eee1ac8851e0f58906d0b0afd988d676
+  metadata.gz: c07e83a315d72de93ec39e4c24b953b7aa65f96cfa7fda272d0f6bc7f18819ba065a407374aef07571b811c5baed4c4bd993c3895c19d39c3d54a0c9eb6c7291
+  data.tar.gz: 17cab126cf09804f07a3025f4daab542ae0a5cbb54ee6026953ec9e67e53784b972560fefd74cb66e5c629808c28114adf9080379e820bba7bf8c51cdac9ce8b

data/CHANGELOG.md

@@ -6,6 +6,14 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.25.18 - 2016-01-08
+
+* [FEATURE] Add Yt::COUNTRIES and Yt::US_STATES
+* [FEATURE] Add YouTube Analytics Video Groups
+* [FEATURE] Add `:video_groups` to Yt::Account (list video-groups created by an account)
+* [FEATURE] Add `:video_groups` to Yt::ContentOwner (list video-groups on behalf of a content owner)
+* [FEATURE] Add reports by video-group
+
 ## 0.25.17 - 2016-01-05
 
 * [FEATURE] Add `:videos` to Yt::ContentOwner to list videos in network with a content owner

data/lib/yt.rb

@@ -1,5 +1,6 @@
 require 'yt/config'
 require 'yt/version'
+require 'yt/constants/geography'
 require 'yt/models/account'
 require 'yt/models/channel'
 require 'yt/models/claim'
@@ -9,6 +10,7 @@ require 'yt/models/match_policy'
 require 'yt/models/playlist'
 require 'yt/models/playlist_item'
 require 'yt/models/video'
+require 'yt/models/video_group'
 require 'yt/models/ownership'
 require 'yt/models/advertising_options_set'
 

data/lib/yt/actions/list.rb

@@ -47,7 +47,7 @@ module Yt
       def find_next
         @items ||= []
         if @items[@last_index].nil? && more_pages?
-          more_items = next_page.map{|data| new_item data}
+          more_items = next_page.map{|data| new_item data}.compact
           @items.concat more_items
         end
         @items[(@last_index +=1) -1]

data/lib/yt/collections/group_infos.rb

@@ -0,0 +1,26 @@
+require 'yt/collections/base'
+require 'yt/models/snippet'
+
+module Yt
+  module Collections
+    # @private
+    class GroupInfos < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {data: data, auth: @auth}
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:path] = "/youtube/analytics/v1/groups"
+          params[:params] = {id: @parent.id}
+          if @auth.owner_name
+            params[:params][:on_behalf_of_content_owner] = @auth.owner_name
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/video_groups.rb

@@ -0,0 +1,28 @@
+require 'yt/collections/base'
+require 'yt/models/video_group'
+require 'yt/models/group_info'
+
+module Yt
+  module Collections
+    # @private
+    class VideoGroups < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {id: data['id'], auth: @auth, group_info: Yt::GroupInfo.new(data: data)}
+      end
+
+      def new_item(data)
+        super if data['contentDetails']['itemType'] == 'youtube#video'
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:path] = "/youtube/analytics/v1/groups"
+          params[:params] = @parent.video_groups_params
+        end
+      end
+    end
+  end
+end

data/lib/yt/constants/geography.rb

@@ -0,0 +1,323 @@
+module Yt
+  # The list of country codes and names used by the YouTube Analytics API.
+  # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#country
+  COUNTRIES = {
+    AC: 'Ascension',
+    AD: 'Andorra',
+    AE: 'United Arab Emirates',
+    AF: 'Afghanistan',
+    AG: 'Antigua and Barbuda',
+    AI: 'Anguilla',
+    AL: 'Albania',
+    AM: 'Armenia',
+    AN: 'Netherlands Antilles',
+    AO: 'Angola',
+    AQ: 'Antarctic Territory',
+    AR: 'Argentina',
+    AS: 'American Samoa',
+    AT: 'Austria',
+    AU: 'Australia',
+    AW: 'Aruba',
+    AX: 'Aland',
+    AZ: 'Azerbaijan',
+    BA: 'Bosnia and Herzegovina',
+    BB: 'Barbados',
+    BD: 'Bangladesh',
+    BE: 'Belgium',
+    BF: 'Burkina Faso',
+    BG: 'Bulgaria',
+    BH: 'Bahrain',
+    BI: 'Burundi',
+    BJ: 'Benin',
+    BL: 'Saint Barthélemy',
+    BM: 'Bermuda',
+    BN: 'Brunei',
+    BO: 'Bolivia',
+    BQ: 'Bonaire, Sint Eustatius and Saba',
+    BR: 'Brazil',
+    BS: 'Bahamas',
+    BT: 'Bhutan',
+    BV: 'Bouvet Island',
+    BW: 'Botswana',
+    BY: 'Belarus',
+    BZ: 'Belize',
+    CA: 'Canada',
+    CC: 'Cocos (Keeling) Islands',
+    CD: 'Congo',
+    CF: 'Central African Republic',
+    CG: 'Congo',
+    CH: 'Switzerland',
+    CI: 'Ivory Coast',
+    CK: 'Cook Islands',
+    CL: 'Chile',
+    CM: 'Cameroon',
+    CN: 'China',
+    CO: 'Colombia',
+    CR: 'Costa Rica',
+    CU: 'Cuba',
+    CV: 'Cape Verde',
+    CW: 'Curaçao',
+    CX: 'Christmas Island',
+    CY: 'Cyprus',
+    CZ: 'Czech Republic',
+    DE: 'Germany',
+    DJ: 'Djibouti',
+    DK: 'Denmark',
+    DM: 'Dominica',
+    DO: 'Dominican Republic',
+    DZ: 'Algeria',
+    EC: 'Ecuador',
+    EE: 'Estonia',
+    EG: 'Egypt',
+    EH: 'Western Sahara',
+    ER: 'Eritrea',
+    ES: 'Spain',
+    ET: 'Ethiopia',
+    FI: 'Finland',
+    FJ: 'Fiji',
+    FK: 'Falkland Islands',
+    FM: 'Micronesia',
+    FO: 'Faroe Islands',
+    FR: 'France',
+    GA: 'Gabon',
+    GB: 'United Kingdom',
+    GD: 'Grenada',
+    GE: 'Georgia',
+    GF: 'French Guiana',
+    GG: 'Guernsey',
+    GH: 'Ghana',
+    GI: 'Gibraltar',
+    GL: 'Greenland',
+    GM: 'Gambia',
+    GN: 'Guinea',
+    GP: 'Guadeloupe',
+    GQ: 'Equatorial Guinea',
+    GR: 'Greece',
+    GS: 'South Georgia & South Sandwich Islands',
+    GT: 'Guatemala',
+    GU: 'Guam',
+    GW: 'Guinea-Bissau',
+    GY: 'Guyana',
+    HK: 'Hong Kong',
+    HM: 'Heard Island and McDonald Islands',
+    HN: 'Honduras',
+    HR: 'Croatia',
+    HT: 'Haiti',
+    HU: 'Hungary',
+    ID: 'Indonesia',
+    IE: 'Ireland',
+    IL: 'Israel',
+    IM: 'Isle of Man',
+    IN: 'India',
+    IO: 'British Indian Ocean Territory',
+    IQ: 'Iraq',
+    IR: 'Iran',
+    IS: 'Iceland',
+    IT: 'Italy',
+    JE: 'Jersey',
+    JM: 'Jamaica',
+    JO: 'Jordan',
+    JP: 'Japan',
+    KE: 'Kenya',
+    KG: 'Kyrgyzstan',
+    KH: 'Cambodia',
+    KI: 'Kiribati',
+    KM: 'Comoros',
+    KN: 'Saint Kitts and Nevis',
+    KP: 'North Korea',
+    KR: 'South Korea',
+    KW: 'Kuwait',
+    KY: 'Cayman Islands',
+    KZ: 'Kazakhstan',
+    LA: 'Laos',
+    LB: 'Lebanon',
+    LC: 'Saint Lucia',
+    LI: 'Liechtenstein',
+    LK: 'Sri Lanka',
+    LR: 'Liberia',
+    LS: 'Lesotho',
+    LT: 'Lithuania',
+    LU: 'Luxembourg',
+    LV: 'Latvia',
+    LY: 'Libya',
+    MA: 'Morocco',
+    MC: 'Monaco',
+    MD: 'Moldova',
+    ME: 'Montenegro',
+    MF: 'Saint Martin',
+    MG: 'Madagascar',
+    MH: 'Marshall Islands',
+    MK: 'Macedonia',
+    ML: 'Mali',
+    MM: 'Myanmar',
+    MN: 'Mongolia',
+    MO: 'Macau',
+    MP: 'Northern Mariana Islands',
+    MQ: 'Martinique',
+    MR: 'Mauritania',
+    MS: 'Montserrat',
+    MT: 'Malta',
+    MU: 'Mauritius',
+    MV: 'Maldives',
+    MW: 'Malawi',
+    MX: 'Mexico',
+    MY: 'Malaysia',
+    MZ: 'Mozambique',
+    NA: 'Namibia',
+    NC: 'New Caledonia',
+    NE: 'Niger',
+    NF: 'Norfolk Island',
+    NG: 'Nigeria',
+    NI: 'Nicaragua',
+    NL: 'Netherlands',
+    NO: 'Norway',
+    NP: 'Nepal',
+    NR: 'Nauru',
+    NU: 'Niue',
+    NZ: 'New Zealand',
+    OM: 'Oman',
+    PA: 'Panama',
+    PE: 'Peru',
+    PF: 'French Polynesia',
+    PG: 'Papua New Guinea',
+    PH: 'Philippines',
+    PK: 'Pakistan',
+    PL: 'Poland',
+    PM: 'Saint Pierre and Miquelon',
+    PN: 'Pitcairn Islands',
+    PR: 'Puerto Rico',
+    PS: 'Palestinian Territory',
+    PT: 'Portugal',
+    PW: 'Palau',
+    PY: 'Paraguay',
+    QA: 'Qatar',
+    RE: 'Reunion',
+    RO: 'Romania',
+    RS: 'Serbia',
+    RU: 'Russia',
+    RW: 'Rwanda',
+    SA: 'Saudi Arabia',
+    SB: 'Solomon Islands',
+    SC: 'Seychelles',
+    SD: 'Sudan',
+    SE: 'Sweden',
+    SG: 'Singapore',
+    SH: 'Saint Helena',
+    SI: 'Slovenia',
+    SJ: 'Svalbard',
+    SK: 'Slovakia',
+    SL: 'Sierra Leone',
+    SM: 'San Marino',
+    SN: 'Senegal',
+    SO: 'Somalia',
+    SR: 'Suriname',
+    SS: 'South Sudan',
+    ST: 'Sao Tome and Principe',
+    SV: 'El Salvador',
+    SX: 'Sint Maarten',
+    SY: 'Syria',
+    SZ: 'Swaziland',
+    TA: 'Tristan da Cunha',
+    TC: 'Turks and Caicos Islands',
+    TD: 'Chad',
+    TF: 'French Southern and Antarctic Lands',
+    TG: 'Togo',
+    TH: 'Thailand',
+    TJ: 'Tajikistan',
+    TK: 'Tokelau',
+    TL: 'East Timor',
+    TM: 'Turkmenistan',
+    TN: 'Tunisia',
+    TO: 'Tonga',
+    TR: 'Turkey',
+    TT: 'Trinidad and Tobago',
+    TV: 'Tuvalu',
+    TW: 'Taiwan',
+    TZ: 'Tanzania',
+    UA: 'Ukraine',
+    UG: 'Uganda',
+    UM: 'Midway Islands',
+    US: 'United States',
+    UY: 'Uruguay',
+    UZ: 'Uzbekistan',
+    VA: 'Vatican City',
+    VC: 'Saint Vincent and the Grenadines',
+    VE: 'Venezuela',
+    VG: 'British Virgin Islands',
+    VI: 'U.S. Virgin Islands',
+    VN: 'Vietnam',
+    VU: 'Vanuatu',
+    XK: 'Kosovo',
+    WF: 'Wallis and Futuna',
+    WS: 'Samoa',
+    YE: 'Yemen',
+    YT: 'Mayotte',
+    ZA: 'South Africa',
+    ZM: 'Zambia',
+    ZW: 'Zimbabwe',
+    ZZ: 'Unknown Region'
+  }.with_indifferent_access
+
+  # The list of U.S. state codes and names used by the YouTube Analytics API.
+  # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#province
+  US_STATES = {
+    AL: 'Alabama',
+    AK: 'Alaska',
+    AZ: 'Arizona',
+    AR: 'Arkansas',
+    CA: 'California',
+    CO: 'Colorado',
+    CT: 'Connecticut',
+    DE: 'Delaware',
+    FL: 'Florida',
+    GA: 'Georgia',
+    HI: 'Hawaii',
+    ID: 'Idaho',
+    IL: 'Illinois',
+    IN: 'Indiana',
+    IA: 'Iowa',
+    KS: 'Kansas',
+    KY: 'Kentucky',
+    LA: 'Louisiana',
+    ME: 'Maine',
+    MD: 'Maryland',
+    MA: 'Massachusetts',
+    MI: 'Michigan',
+    MN: 'Minnesota',
+    MS: 'Mississippi',
+    MO: 'Missouri',
+    MT: 'Montana',
+    NE: 'Nebraska',
+    NV: 'Nevada',
+    NH: 'New Hampshire',
+    NJ: 'New Jersey',
+    NM: 'New Mexico',
+    NY: 'New York',
+    NC: 'North Carolina',
+    ND: 'North Dakota',
+    OH: 'Ohio',
+    OK: 'Oklahoma',
+    OR: 'Oregon',
+    PA: 'Pennsylvania',
+    RI: 'Rhode Island',
+    SC: 'South Carolina',
+    SD: 'South Dakota',
+    TN: 'Tennessee',
+    TX: 'Texas',
+    UT: 'Utah',
+    VT: 'Vermont',
+    VA: 'Virginia',
+    WA: 'Washington',
+    WV: 'West Virginia',
+    WI: 'Wisconsin',
+    WY: 'Wyoming',
+    DC: 'District of Columbia',
+    AS: 'American Samoa',
+    GU: 'Guam',
+    MP: 'Northern Mariana Islands',
+    PR: 'Puerto Rico',
+    UM: 'United States Minor Outlying Islands',
+    VI: 'Virgin Islands, U.S.',
+    ZZ: 'Unknown Region'
+  }.with_indifferent_access
+end

data/lib/yt/models/account.rb

@@ -160,6 +160,11 @@ module Yt
       #     upload videos using the resumable upload protocol.
       has_many :resumable_sessions
 
+      # @!attribute [r] video_groups
+      #   @return [Yt::Collections::VideoGroups] the video-groups created by the
+      #     account.
+      has_many :video_groups
+
     ### PRIVATE API ###
 
       has_authentication
@@ -180,6 +185,13 @@ module Yt
         {for_mine: true}
       end
 
+      # @private
+      # Tells `has_many :video_groups` that content_owner.groups should return
+      # all the video-groups *owned by* the account
+      def video_groups_params
+        {mine: true}
+      end
+
       # @private
       # Tells `has_many :resumable_sessions` what path to hit to upload a file.
       def upload_path

data/lib/yt/models/content_owner.rb

@@ -30,6 +30,11 @@ module Yt
       # @return [String] The display name of the content owner.
       attr_reader :display_name
 
+      # @!attribute [r] video_groups
+      #   @return [Yt::Collections::VideoGroups] the video-groups managed by the
+      #     content owner.
+      has_many :video_groups
+
       def initialize(options = {})
         super options
         @owner_name = options[:owner_name]
@@ -56,6 +61,13 @@ module Yt
       def videos_params
         {for_content_owner: true, on_behalf_of_content_owner: @owner_name}
       end
+
+      # @private
+      # Tells `has_many :video_groups` that content_owner.video_groups should
+      # return all the video-groups *on behalf of* the content owner
+      def video_groups_params
+        {on_behalf_of_content_owner: @owner_name}
+      end
     end
   end
 end

data/lib/yt/models/group_info.rb

@@ -0,0 +1,16 @@
+module Yt
+  module Models
+    class GroupInfo < Base
+      attr_reader :data
+
+      def initialize(options = {})
+        @data = options[:data]['snippet'].merge options[:data]['contentDetails']
+        @auth = options[:auth]
+      end
+
+      has_attribute :title, default: ''
+      has_attribute :item_count, type: Integer
+      has_attribute :published_at, type: Time
+    end
+  end
+end

data/lib/yt/models/video_group.rb

@@ -0,0 +1,127 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube Analytics video-groups.
+    # @see https://developers.google.com/youtube/analytics/v1/reference/groups
+    class VideoGroup < Base
+      # @private
+      attr_reader :id, :auth
+
+    ### GROUP INFO ###
+
+      has_one :group_info
+
+      # @!attribute [r] title
+      #   @return [String] the title of the group.
+      delegate :title, to: :group_info
+
+      # @!attribute [r] item_count
+      #   @return [Integer] the number of resources in the group.
+      delegate :item_count, to: :group_info
+
+      # @!attribute [r] published_at
+      #   @return [Time] the date and time when the group was created.
+      delegate :published_at, to: :group_info
+
+    ### ANALYTICS ###
+
+      # @macro reports
+
+      # @macro report_by_video_dimensions
+      has_report :views, Integer
+
+      # @macro report_by_day
+      has_report :uniques, Integer
+
+      # @macro report_by_video_dimensions
+      has_report :estimated_minutes_watched, Integer
+
+      # @macro report_by_gender_and_age_group
+      has_report :viewer_percentage, Float
+
+      # @macro report_by_day_and_country
+      has_report :comments, Integer
+
+      # @macro report_by_day_and_country
+      has_report :likes, Integer
+
+      # @macro report_by_day_and_country
+      has_report :dislikes, Integer
+
+      # @macro report_by_day_and_country
+      has_report :shares, Integer
+
+      # @note This is not the total number of subscribers gained by the video’s
+      #   channel, but the subscribers gained *from* the video’s page.
+      # @macro report_by_day_and_country
+      has_report :subscribers_gained, Integer
+
+      # @note This is not the total number of subscribers lost by the video’s
+      #   channel, but the subscribers lost *from* the video’s page.
+      # @macro report_by_day_and_country
+      has_report :subscribers_lost, Integer
+
+      # @macro report_by_day_and_country
+      has_report :favorites_added, Integer
+
+      # @macro report_by_day_and_country
+      has_report :favorites_removed, Integer
+
+      # @macro report_by_day_and_country
+      has_report :videos_added_to_playlists, Integer
+
+      # @macro report_by_day_and_country
+      has_report :videos_removed_from_playlists, Integer
+
+      # @macro report_by_day_and_state
+      has_report :average_view_duration, Integer
+
+      # @macro report_by_day_and_state
+      has_report :average_view_percentage, Float
+
+      # @macro report_by_day_and_state
+      has_report :annotation_clicks, Integer
+
+      # @macro report_by_day_and_state
+      has_report :annotation_click_through_rate, Float
+
+      # @macro report_by_day_and_state
+      has_report :annotation_close_rate, Float
+
+      # @macro report_by_day_and_country
+      has_report :earnings, Float
+
+      # @macro report_by_day_and_country
+      has_report :impressions, Integer
+
+      # @macro report_by_day_and_country
+      has_report :monetized_playbacks, Integer
+
+      # @macro report_by_day_and_country
+      has_report :playback_based_cpm, Float
+
+    ### PRIVATE API ###
+
+      # @private
+      def initialize(options = {})
+        @id = options[:id]
+        @auth = options[:auth]
+        @group_info = options[:group_info] if options[:group_info]
+      end
+
+      # @private
+      # Tells `has_reports` to retrieve group reports from the Analytics API.
+      def reports_params
+        {}.tap do |params|
+          if auth.owner_name
+            params[:ids] = "contentOwner==#{auth.owner_name}"
+          else
+            params[:ids] = "channel==mine"
+          end
+          params[:filters] = "group==#{id}"
+        end
+      end
+    end
+  end
+end

data/lib/yt/request.rb

@@ -210,6 +210,7 @@ module Yt
         Errno::ENETUNREACH,
         Errno::ECONNRESET,
         Net::OpenTimeout,
+        SocketError,
         Net::HTTPServerError
       ] + extra_server_errors
     end
@@ -233,7 +234,7 @@ module Yt
       @retries_so_far += 1
       if (@retries_so_far < max_retries)
         @response = @http_request = @uri = nil
-        sleep 3
+        sleep 3 + (10 * @retries_so_far)
       end
     end
 

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.25.17'
+  VERSION = '0.25.18'
 end

data/spec/constants/geography_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require 'yt/constants/geography'
+
+describe 'Yt::COUNTRIES' do
+  it 'returns all country codes and names' do
+    expect(Yt::COUNTRIES[:US]).to eq 'United States'
+    expect(Yt::COUNTRIES['IT']).to eq 'Italy'
+  end
+end
+
+describe 'Yt::US_STATES' do
+  it 'returns all U.S. state codes and names' do
+    expect(Yt::US_STATES[:CA]).to eq 'California'
+    expect(Yt::US_STATES['CO']).to eq 'Colorado'
+  end
+end

data/spec/models/request_spec.rb

@@ -178,6 +178,27 @@ describe Yt::Request do
           it { expect{request.run}.not_to fail }
         end
       end
+
+      # NOTE: This test is just a reflection of YouTube irrational behavior of
+      # being unavailable once in a while, and therefore causing Net::HTTP to
+      # fail, although retrying after some seconds works.
+      context 'a SocketError', ruby21: true do
+        let(:http_error) { SocketError.new }
+
+        context 'every time' do
+          before { expect(Net::HTTP).to receive(:start).at_least(:once).and_raise http_error }
+
+          it { expect{request.run}.to fail }
+        end
+
+        context 'but works the second time' do
+          before { expect(Net::HTTP).to receive(:start).at_least(:once).and_return retry_response }
+          before { allow(retry_response).to receive(:body) }
+          let(:retry_response) { Net::HTTPOK.new nil, nil, nil }
+
+          it { expect{request.run}.not_to fail }
+        end
+      end
     end
   end
 end

data/spec/requests/as_account/account_spec.rb

@@ -97,6 +97,21 @@ describe Yt::Account, :device_app do
     end
   end
 
+  describe '.video_groups' do
+    let(:video_group) { $account.video_groups.first }
+
+    specify 'returns the first video-group created by the account' do
+      expect(video_group).to be_a Yt::VideoGroup
+      expect(video_group.title).to be_a String
+      expect(video_group.item_count).to be_an Integer
+      expect(video_group.published_at).to be_a Time
+    end
+
+    specify 'allows to run reports against each video-group' do
+      expect(video_group.views).to be
+    end
+  end
+
   describe '.upload_video' do
     let(:video_params) { {title: 'Test Yt upload', privacy_status: 'private', category_id: 17} }
     let(:video) { $account.upload_video path_or_url, video_params }

data/spec/requests/as_content_owner/content_owner_spec.rb

@@ -51,6 +51,20 @@ describe Yt::ContentOwner, :partner do
     end
   end
 
+  describe '.video_groups' do
+    let(:video_group) { $content_owner.video_groups.first }
+
+    specify 'returns the first video-group created by the account' do
+      expect(video_group).to be_a Yt::VideoGroup
+      expect(video_group.title).to be_a String
+      expect(video_group.item_count).to be_an Integer
+      expect(video_group.published_at).to be_a Time
+    end
+
+    specify 'allows to run reports against each video-group' do
+      expect(video_group.views).to be
+    end
+  end
 
   describe 'claims' do
     let(:asset_id) { ENV['YT_TEST_PARTNER_ASSET_ID'] }

data/spec/requests/as_content_owner/video_group_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+require 'yt/models/video_group'
+
+describe Yt::VideoGroup, :partner do
+  subject(:video_group) { Yt::VideoGroup.new id: id, auth: $content_owner }
+
+  context 'given a video-group', :partner do
+    context 'managed by the authenticated Content Owner' do
+      let(:id) { ENV['YT_TEST_PARTNER_VIDEO_GROUP_ID'] }
+
+      specify 'the title can be retrieved' do
+        expect(video_group.title).to be_a(String)
+        expect(video_group.title).not_to be_empty
+      end
+
+      specify 'the number of videos in the group can be retrieved' do
+        expect(video_group.item_count).to be_an(Integer)
+        expect(video_group.item_count).not_to be_zero
+      end
+
+      describe 'multiple reports can be retrieved at once' do
+        metrics = {views: Integer, uniques: Integer,
+          estimated_minutes_watched: Integer, comments: Integer, likes: Integer,
+          dislikes: Integer, shares: Integer, subscribers_gained: Integer,
+          subscribers_lost: Integer, favorites_added: Integer,
+          videos_added_to_playlists: Integer, videos_removed_from_playlists: Integer,
+          favorites_removed: Integer, average_view_duration: Integer,
+          average_view_percentage: Float, annotation_clicks: Integer,
+          annotation_click_through_rate: Float,
+          annotation_close_rate: Float, earnings: Float, impressions: Integer,
+          monetized_playbacks: Integer}
+
+        specify 'by day, and are chronologically sorted' do
+          range = {since: 5.days.ago.to_date, until: 3.days.ago.to_date}
+          result = video_group.reports range.merge(only: metrics, by: :day)
+          metrics.each do |metric, type|
+            expect(result[metric].keys).to all(be_a Date)
+            expect(result[metric].values).to all(be_a type)
+            expect(result[metric].keys.sort).to eq result[metric].keys
+          end
+        end
+
+        # NOTE: all the other filters also apply, not tested for brevity
+      end
+
+      describe 'viewer_percentage can be grouped by age group' do
+        let(:range) { {since: 1.year.ago.to_date, until: 1.week.ago.to_date} }
+        let(:keys) { range.values }
+
+        specify 'with the :by option set to :age_group' do
+          viewer_percentage = video_group.viewer_percentage range.merge by: :age_group
+          expect(viewer_percentage.keys - %w(65- 35-44 45-54 13-17 25-34 55-64 18-24)).to be_empty
+          expect(viewer_percentage.values).to all(be_instance_of Float)
+        end
+      end
+    end
+
+    context 'not managed by the authenticated Content Owner' do
+      let(:id) { 'ABExJp9gAAA' }
+
+      specify 'views cannot be retrieved' do
+        expect{video_group.views}.to raise_error Yt::Error
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,7 +1,7 @@
 require 'simplecov'
 require 'coveralls'
 
-SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter.new [
   SimpleCov::Formatter::HTMLFormatter,
   Coveralls::SimpleCov::Formatter
 ]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.25.17
+  version: 0.25.18
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-01-05 00:00:00.000000000 Z
+date: 2016-01-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -142,6 +142,7 @@ files:
 - lib/yt/collections/content_owners.rb
 - lib/yt/collections/device_flows.rb
 - lib/yt/collections/file_details.rb
+- lib/yt/collections/group_infos.rb
 - lib/yt/collections/ids.rb
 - lib/yt/collections/live_streaming_details.rb
 - lib/yt/collections/ownerships.rb
@@ -165,8 +166,10 @@ files:
 - lib/yt/collections/subscriptions.rb
 - lib/yt/collections/user_infos.rb
 - lib/yt/collections/video_categories.rb
+- lib/yt/collections/video_groups.rb
 - lib/yt/collections/videos.rb
 - lib/yt/config.rb
+- lib/yt/constants/geography.rb
 - lib/yt/errors/forbidden.rb
 - lib/yt/errors/missing_auth.rb
 - lib/yt/errors/no_items.rb
@@ -192,6 +195,7 @@ files:
 - lib/yt/models/description.rb
 - lib/yt/models/device_flow.rb
 - lib/yt/models/file_detail.rb
+- lib/yt/models/group_info.rb
 - lib/yt/models/id.rb
 - lib/yt/models/iterator.rb
 - lib/yt/models/live_streaming_detail.rb
@@ -217,6 +221,7 @@ files:
 - lib/yt/models/user_info.rb
 - lib/yt/models/video.rb
 - lib/yt/models/video_category.rb
+- lib/yt/models/video_group.rb
 - lib/yt/request.rb
 - lib/yt/version.rb
 - spec/collections/claims_spec.rb
@@ -227,6 +232,7 @@ files:
 - spec/collections/reports_spec.rb
 - spec/collections/subscriptions_spec.rb
 - spec/collections/videos_spec.rb
+- spec/constants/geography_spec.rb
 - spec/errors/forbidden_spec.rb
 - spec/errors/missing_auth_spec.rb
 - spec/errors/no_items_spec.rb
@@ -283,6 +289,7 @@ files:
 - spec/requests/as_content_owner/match_policy_spec.rb
 - spec/requests/as_content_owner/ownership_spec.rb
 - spec/requests/as_content_owner/playlist_spec.rb
+- spec/requests/as_content_owner/video_group_spec.rb
 - spec/requests/as_content_owner/video_spec.rb
 - spec/requests/as_server_app/channel_spec.rb
 - spec/requests/as_server_app/playlist_item_spec.rb
@@ -328,6 +335,7 @@ test_files:
 - spec/collections/reports_spec.rb
 - spec/collections/subscriptions_spec.rb
 - spec/collections/videos_spec.rb
+- spec/constants/geography_spec.rb
 - spec/errors/forbidden_spec.rb
 - spec/errors/missing_auth_spec.rb
 - spec/errors/no_items_spec.rb
@@ -384,6 +392,7 @@ test_files:
 - spec/requests/as_content_owner/match_policy_spec.rb
 - spec/requests/as_content_owner/ownership_spec.rb
 - spec/requests/as_content_owner/playlist_spec.rb
+- spec/requests/as_content_owner/video_group_spec.rb
 - spec/requests/as_content_owner/video_spec.rb
 - spec/requests/as_server_app/channel_spec.rb
 - spec/requests/as_server_app/playlist_item_spec.rb