yt 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 17691684dae81110d7d3ff39e8952823deedc5ac
-  data.tar.gz: a2438b53994ef551b3525a310db27990695a7f1d
+  metadata.gz: 5fe27d147e90b10dde52f153efedf061043b9788
+  data.tar.gz: fb07f986240215dba34f01d78762503471cf61a5
 SHA512:
-  metadata.gz: 9994436e29b6ef5b5bc3533db28e5f40e2839948076f30cac3794769b4e962cd0dee3dc88e4f1f52641420cd401b62070d8cc8bcf9aae4eabf349b397bfa6408
-  data.tar.gz: 98f99214f24da915e60247d4192579b93b5579e5e16e83cde009bd017f21c46c5a9a6c22a7451b291c1e4afd69fc130570b29fd419b37b1d96d9148a0469e6fb
+  metadata.gz: 0c20df4b1ad2ac9420d3bd183e04892f9cffaaefb3989330794ce8004de7f06c8ce6b52260980582f2cc22e5239871c24aa868156d27bd488465184dd8940da3
+  data.tar.gz: b4ec8a79ced4d3e5535a68daa4ae56f593d70e8bd86d20c0c3ef041ca85c88266b77f2f787a7fe1bf08fd04b61b4738ffc02ab3b93d5cce8699ba60c3c7d701b

data/CHANGELOG.md

@@ -6,6 +6,23 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.20.0 - 2015-04-29
+
+**How to upgrade**
+
+If your code doesn’t use any of the following constants that were public but
+undocumented, then you are good to go.
+
+If it does, then you should redefine those constants in your own app, since
+it’s not Yt’s goal to validate the values posted to YouTube API.
+
+* [REMOVAL] Remove `Asset#STATUSES` (was `%q(active inactive pending)`).
+* [REMOVAL] Remove `Claim#STATUSES` (was `%q(active appealed disputed inactive pending potential takedown unknown)`).
+* [REMOVAL] Remove `Claim#CONTENT_TYPES` (was `%q(audio video audiovisual)`).
+* [REMOVAL] Remove `Reference#STATUSES` (was `%q(activating active checking computing_fingerprint deleted duplicate_on_hold inactive live_streaming_processing urgent_reference_processing)`).
+* [REMOVAL] Remove `Reference#CONTENT_TYPES` (was `%q(audio video audiovisual)`).
+* [REMOVAL] Remove `Status#PRIVACY_STATUSES` (was `%q(private public unlisted)`).
+
 ## 0.19.0 - 2015-04-28
 
 **How to upgrade**

data/README.md

@@ -41,7 +41,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the Gemfile:
 
-    gem 'yt', '~> 0.19.0'
+    gem 'yt', '~> 0.20.0'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)

data/lib/yt/associations/has_reports.rb

@@ -1,12 +1,10 @@
 module Yt
   module Associations
+    # @private
     # Provides methods to access the analytics reports of a resource.
-    #
-    # YouTube resources with reports are: {Yt::Models::Channel channels} and
-    # {Yt::Models::Channel videos}.
     module HasReports
       # @!macro [new] report
-      #   Returns the $1 of the video grouped by the given dimension.
+      #   Returns the $1 grouped by the given dimension.
       #   @!method $1(options = {})
       #   @param [Hash] options the time-range and dimensions for the $1.
       #   @option options [#to_date] :since The first day of the time-range.
@@ -14,65 +12,103 @@ module Yt
       #   @option options [#to_date] :until The last day of the time-range.
       #     Also aliased as +:to+.
 
-      # @!macro [new] daily_report
-      #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
-      #     Accepted values are: +:day+.
-      #   @return [Hash<Date, Float>] if grouped by day, the $1 of the video
+      # @!macro [new] report_with_day
+      #   @return [Hash<Date, Float>] if grouped by day, the $1
       #     for each day in the time-range.
-      #   @example Get the video’s $1 for each day of last week:
-      #     video.$1 since: 2.weeks.ago, until: 1.week.ago, by: :day
+      #   @example Get the $1 for each day of last week:
+      #     resource.$1 since: 2.weeks.ago, until: 1.week.ago, by: :day
       #     # => {Wed, 8 May 2014 => 12.0, Thu, 9 May 2014 => 34.2, …}
       #   @macro report
 
-      # @!macro [new] views_report
+      # @!macro [new] report_by_day
       #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
-      #     Accepted values are: +:day+, +:traffic_source+,
-      #     +:playback_location+,+:embedded_player_location+, +:related_video+.
-      #   @return [Hash<Date, Float>] if grouped by day, the $1 of the video
-      #     for each day in the time-range.
-      #   @example Get the video’s $1 for each day of last week:
-      #     video.$1 since: 2.weeks.ago, until: 1.week.ago, by: :day
-      #     # => {Wed, 8 May 2014 => 12.0, Thu, 9 May 2014 => 34.2, …}
-      #   @return [Hash<Symbol, Float>] if grouped by traffic source, the
-      #     $1 of the video for each traffic source.
-      #   @example Get yesterday’s video’s $1 grouped by traffic source:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago, by: :traffic_source
-      #     # => {advertising: 53.0, channel: 7.0, …}
+      #     Accepted values are: +:day+.
+      #   @macro report_with_day
+
+      # @!macro [new] report_with_video_dimensions
       #   @return [Hash<Symbol, Float>] if grouped by playback location, the
-      #     $1 of the video for each traffic playback location.
-      #   @example Get yesterday’s video’s $1 grouped by playback location:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago, by: :playback_location
+      #     $1 for each traffic playback location.
+      #   @example Get yesterday’s $1 grouped by playback location:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :playback_location
       #     # => {embedded: 53.0, watch: 467.0, …}
+      #   @return [Hash<Yt::Video, Float>] if grouped by related video, the
+      #     $1 for each related video.
+      #   @example Get yesterday’s $1 by related video:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :related_video
+      #     # => {#<Yt::Video @id=…> => 33.0, #<Yt::Video @id=…> => 12.0, …}
+      #   @return [Hash<Yt::Video, Float>] if grouped by device type, the
+      #     $1 for each device type.
+      #   @example Get yesterday’s $1 by device type:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :device_type
+      #     # => {mobile: 133.0, tv: 412.0, …}
+      #   @return [Hash<Yt::Video, Float>] if grouped by traffic source, the
+      #     $1 for each traffic source.
+      #   @example Get yesterday’s $1 by traffic source:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :traffic_source
+      #     # => {advertising: 543.0, playlist: 92.0, …}
+      #   @macro report_with_day
+
+      # @!macro [new] report_by_video_dimensions
+      #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
+      #     Accepted values are: +:day+, +:traffic_source+,
+      #     +:playback_location+, +:related_video+, +:embedded_player_location+.
       #   @return [Hash<Symbol, Float>] if grouped by embedded player location,
-      #     the $1 of the video for each embedded player location.
-      #   @example Get yesterday’s video’s $1 by embedded player location:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago, by: :embedded_player_location
+      #     the $1 for each embedded player location.
+      #   @example Get yesterday’s $1 by embedded player location:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :embedded_player_location
       #     # => {"fullscreen.net" => 92.0, "yahoo.com" => 14.0, …}
-      #   @return [Hash<Yt::Video, Float>] if grouped by related video, the
-      #     $1 of the video for each related video.
-      #   @example Get yesterday’s video’s $1 by related video:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago, by: :related_video
+      #   @macro report_with_video_dimensions
+
+      # @!macro [new] report_with_channel_dimensions
+      #   @return [Hash<Yt::Video, Float>] if grouped by video, the
+      #     $1 for each video.
+      #   @example Get yesterday’s $1 by video:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :video
       #     # => {#<Yt::Video @id=…> => 33.0, #<Yt::Video @id=…> => 12.0, …}
-      #   @macro report
+      #   @return [Hash<Yt::Video, Float>] if grouped by playlist, the
+      #     $1 for each playlist.
+      #   @example Get yesterday’s $1 by playlist:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :playlist
+      #     # => {#<Yt::Video @id=…> => 33.0, #<Yt::Video @id=…> => 12.0, …}
+      #   @macro report_with_video_dimensions
+
+      # @!macro [new] report_by_channel_dimensions
+      #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
+      #     Accepted values are: +:day+, +:traffic_source+,
+      #     +:playback_location+, +:related_video+, +:video+,
+      #     +:playlist+, +:embedded_player_location+.
+      #   @return [Hash<Symbol, Float>] if grouped by embedded player location,
+      #     the $1 for each embedded player location.
+      #   @example Get yesterday’s $1 by embedded player location:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :embedded_player_location
+      #     # => {"fullscreen.net" => 92.0, "yahoo.com" => 14.0, …}
+      #   @macro report_with_channel_dimensions
+
+      # @!macro [new] report_by_playlist_dimensions
+      #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
+      #     Accepted values are: +:day+, +:traffic_source+,
+      #     +:playback_location+, +:related_video+, +:video+,
+      #     +:playlist+.
+      #   @macro report_with_channel_dimensions
 
-      # @!macro [new] demographics_report
+      # @!macro [new] report_by_gender_and_age_group
       #   @option options [Symbol] :by (:gender_age_group) The dimension to
       #     show viewer percentage by.
       #     Accepted values are: +:gender+, +:age_group+, +:gender_age_group+.
-      #   @return [Hash<Symbol, Float>] if grouped by gender, the video’s
+      #   @return [Hash<Symbol, Float>] if grouped by gender, the
       #     viewer percentage by gender.
-      #   @example Get yesterday’s video’s viewer percentage by gender:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago, by: :gender
+      #   @example Get yesterday’s viewer percentage by gender:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :gender
       #     # => {female: 53.0, male: 47.0}
-      #   @return [Hash<String, Float>] if grouped by age group, the video’s
+      #   @return [Hash<String, Float>] if grouped by age group, the
       #     viewer percentage by age group.
-      #   @example Get yesterday’s video’s $1 grouped by age group:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago, by: :age_group
+      #   @example Get yesterday’s $1 grouped by age group:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago, by: :age_group
       #     # => {"18-24" => 4.54, "35-24" => 12.31, "45-34" => 8.92, …}
       #   @return [Hash<Symbol, [Hash<String, Float>]>] if grouped by gender
-      #     and age group, the video’s viewer percentage by gender/age group.
-      #   @example Get yesterday’s video’s $1 by gender and age group:
-      #     video.$1 from: 1.day.ago, to: 1.day.ago
+      #     and age group, the viewer percentage by gender/age group.
+      #   @example Get yesterday’s $1 by gender and age group:
+      #     resource.$1 from: 1.day.ago, to: 1.day.ago
       #     # => {female: {"18-24" => 12.12, "25-34" => 16.16, …}, male:…}
       #   @macro report
 

data/lib/yt/models/annotation.rb

@@ -71,6 +71,7 @@ module Yt
         timestamps.first < seconds if timestamps.any?
       end
 
+      # @return [String] the textual content of the annotation.
       def text
         @text ||= @data['TEXT'] || ''
       end

data/lib/yt/models/asset.rb

@@ -72,8 +72,6 @@ module Yt
 
 # Status
 
-      STATUSES = %q(active inactive pending)
-
       # Returns the asset’s status.
       # @return [String] the asset’s status. Possible values are: +'active'+,
       #   +'inactive'+, +'pending'+.

data/lib/yt/models/channel.rb

@@ -2,9 +2,90 @@ require 'yt/models/resource'
 
 module Yt
   module Models
-    # A channel resource contains information about a YouTube channel.
+    # Provides methods to interact with YouTube channels.
     # @see https://developers.google.com/youtube/v3/docs/channels
     class Channel < Resource
+
+    ### SNIPPET ###
+
+      # @!attribute [r] title
+      # @return [String] the channel’s title.
+      delegate :title, to: :snippet
+
+      # @!attribute [r] description
+      # @return [String] the channel’s description.
+      delegate :description, to: :snippet
+
+      # Returns the URL of the channel’s thumbnail.
+      # @!method thumbnail_url(size = :default)
+      # @param [Symbol, String] size The size of the channel’s thumbnail.
+      # @return [String] if +size+ is +default+, the URL of a 88x88px image.
+      # @return [String] if +size+ is +medium+, the URL of a 240x240px image.
+      # @return [String] if +size+ is +high+, the URL of a 800x800px image.
+      # @return [nil] if the +size+ is not +default+, +medium+ or +high+.
+      delegate :thumbnail_url, to: :snippet
+
+      # @!attribute [r] published_at
+      # @return [Time] the date and time that the channel was created.
+      delegate :published_at, to: :snippet
+
+    ### SUBSCRIPTION ###
+
+      has_one :subscription
+
+      # @return [Boolean] whether the account is subscribed to the channel.
+      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account.
+      def subscribed?
+        sleep [(@subscriptions_updated_at || Time.now) - Time.now, 0].max
+        subscription.exists?
+      rescue Errors::NoItems
+        false
+      end
+
+      # Subscribes the authenticated account to the channel.
+      # Unlike {#subscribe!}, does not raise an error if already subscribed.
+      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account.
+      def subscribe
+        subscriptions.insert(ignore_errors: true).tap do |subscription|
+          throttle_subscriptions
+          @subscription = subscription
+        end
+      end
+
+      # Subscribes the authenticated account to the channel.
+      # Unlike {#subscribe}, raises an error if already subscribed.
+      # @raise [Yt::Errors::RequestError] if already subscribed.
+      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account.
+      def subscribe!
+        subscriptions.insert.tap do |subscription|
+          throttle_subscriptions
+          @subscription = subscription
+        end
+      end
+
+      # Unsubscribes the authenticated account from the channel.
+      # Unlike {#unsubscribe!}, does not raise an error if already unsubscribed.
+      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account.
+      def unsubscribe
+        unsubscribe! if subscribed?
+      end
+
+      # Unsubscribes the authenticated account from the channel.
+      # Unlike {#unsubscribe}, raises an error if already unsubscribed.
+      #
+      # @raise [Yt::Errors::RequestError] if already unsubscribed.
+      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account.
+      def unsubscribe!
+        subscription.delete.tap{ throttle_subscriptions }
+      end
+
+    ### ASSOCIATIONS ###
+
       # @!attribute [r] videos
       #   @return [Yt::Collections::Videos] the channel’s videos.
       has_many :videos
@@ -13,168 +94,154 @@ module Yt
       #   @return [Yt::Collections::Playlists] the channel’s playlists.
       has_many :playlists
 
-      # @macro has_report
-      has_report :earnings
+      # @!attribute [r] subscribed_channels
+      #   @return [Yt::Collections::SubscribedChannels] the channels that this
+      #     channel is subscribed to.
+      #   @raise [Yt::Errors::Forbidden] if the owner of the channel has
+      #     explicitly select the option to keep all subscriptions private.
+      has_many :subscribed_channels
+
+    ### ANALYTICS ###
 
-      # @macro has_report
+      # @macro report_by_channel_dimensions
       has_report :views
 
-      # @macro has_report
+      # @macro report_by_channel_dimensions
+      has_report :estimated_minutes_watched
+
+      # @macro report_by_gender_and_age_group
+      has_report :viewer_percentage
+
+      # @macro report_by_day
       has_report :comments
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :likes
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :dislikes
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :shares
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :subscribers_gained
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :subscribers_lost
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :favorites_added
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :favorites_removed
 
-      # @macro has_report
-      has_report :estimated_minutes_watched
-
-      # @macro has_report
+      # @macro report_by_day
       has_report :average_view_duration
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :average_view_percentage
 
-      # @macro has_report
-      has_report :impressions
-
-      # @macro has_report
-      has_report :monetized_playbacks
-
-      # @macro has_report
+      # @macro report_by_day
       has_report :annotation_clicks
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :annotation_click_through_rate
 
-      # @macro has_report
+      # @macro report_by_day
       has_report :annotation_close_rate
 
-      # @macro has_report
-      has_report :viewer_percentage
+      # @macro report_by_day
+      has_report :earnings
+
+      # @macro report_by_day
+      has_report :impressions
+
+      # @macro report_by_day
+      has_report :monetized_playbacks
+
+    ### STATISTICS ###
 
-      # @!attribute [r] statistics_set
-      #   @return [Yt::Models::StatisticsSet] the statistics for the video.
       has_one :statistics_set
-      delegate :view_count, :comment_count, :video_count, :subscriber_count,
-        :subscriber_count_visible?, to: :statistics_set
 
-      # @!attribute [r] content_owner_detail
-      #   @return [Yt::Models::ContentOwnerDetail] the video’s content owner
-      #     details.
-      has_one :content_owner_detail
-      delegate :content_owner, :linked_at, to: :content_owner_detail
+      # @!attribute [r] view_count
+      # @return [Integer] the number of times the channel has been viewed.
+      delegate :view_count, to: :statistics_set
 
-      # @!attribute [r] subscribed_channels
-      #   @return [Yt::Collections::SubscribedChannels] the channels that the channel is subscribed to.
-      #   @raise [Yt::Errors::Forbidden] if the owner of the channel has
-      #     explicitly select the option to keep all subscriptions private.
-      has_many :subscribed_channels
+      # @!attribute [r] comment_count
+      # @return [Integer] the number of comments for the channel.
+      delegate :comment_count, to: :statistics_set
 
-      # @!attribute [r] subscription
-      #   @return [Yt::Models::Subscription] the channel’s subscription by auth.
-      #   @raise [Yt::Errors::NoItems] if {Resource#auth auth} is not
-      #     subscribed to the channel.
-      #   @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} does not
-      #     return an authenticated account.
-      has_one :subscription
+      # @!attribute [r] video_count
+      # @return [Integer] the number of videos uploaded to the channel.
+      delegate :video_count, to: :statistics_set
 
-      # Override Resource's new to set statistics as well
-      # if the response includes them
-      def initialize(options = {})
-        super options
-        if options[:statistics]
-          @statistics_set = StatisticsSet.new data: options[:statistics]
-        end
-      end
+      # @!attribute [r] subscriber_count
+      # @return [Integer] the number of subscriber the channel has.
+      delegate :subscriber_count, to: :statistics_set
 
-      # Returns whether the authenticated account is subscribed to the channel.
-      #
-      # This method requires {Resource#auth auth} to return an
-      # authenticated instance of {Yt::Account}.
-      # @return [Boolean] whether the account is subscribed to the channel.
-      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} does not
-      #   return an authenticated account.
-      def subscribed?
-        sleep [(@subscriptions_updated_at || Time.now) - Time.now, 0].max
-        subscription.exists?
-      rescue Errors::NoItems
-        false
+      # @return [Boolean] whether the number of subscribers is publicly visible.
+      def subscriber_count_visible?
+        statistics_set.hidden_subscriber_count == false
       end
 
-      # Unsubscribes the authenticated account from the channel.
-      # Raises an error if the account was not subscribed.
-      #
-      # This method requires {Resource#auth auth} to return an
-      # authenticated instance of {Yt::Account}.
-      # @raise [Yt::Errors::RequestError] if {Resource#auth auth} was not
-      #   subscribed to the channel.
-      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} does not
-      #   return an authenticated account.
-      def unsubscribe!
-        subscription.delete.tap{ throttle_subscriptions }
-      end
+    ### CONTENT OWNER DETAILS ###
 
-      # Unsubscribes the authenticated account from the channel.
-      # Does not raise an error if the account was not subscribed.
-      #
-      # This method requires {Resource#auth auth} to return an
-      # authenticated instance of {Yt::Account}.
-      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} does not
-      #   return an authenticated account.
-      def unsubscribe
-        unsubscribe! if subscribed?
-      end
+      has_one :content_owner_detail
 
-      # Subscribes the authenticated account to the channel.
-      # Raises an error if the account was already subscribed.
-      #
-      # This method requires {Resource#auth auth} to return an
-      # authenticated instance of {Yt::Account}.
-      # @raise [Yt::Errors::RequestError] if {Resource#auth auth} was already
-      #   subscribed to the channel.
-      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} does not
-      #   return an authenticated account.
-      def subscribe!
-        subscriptions.insert.tap do |subscription|
-          throttle_subscriptions
-          @subscription = subscription
-        end
+      # The name of the content owner linked to the channel.
+      # @!attribute [r] content_owner
+      # @return [String] if the channel is partnered, its content owner’s name.
+      # @return [nil] if the channel is not partnered or if {Resource#auth auth}
+      #   is a content owner without permissions to administer the channel.
+      # @raise [Yt::Errors::Forbidden] if {Resource#auth auth} does not
+      #   return an authenticated content owner.
+      delegate :content_owner, to: :content_owner_detail
+
+      # Returns the time the channel was partnered to a content owner.
+      # @return [Time] if the channel is partnered, the time when it was linked
+      #   to its content owner.
+      # @return [nil] if the channel is not partnered or if {Resource#auth auth}
+      #   is a content owner without permissions to administer the channel.
+      # @raise [Yt::Errors::Forbidden] if {Resource#auth auth} does not
+      #   return an authenticated content owner.
+      def linked_at
+        content_owner_detail.time_linked
       end
 
-      # Subscribes the authenticated account to the channel.
-      # Does not raise an error if the account was already subscribed.
-      #
-      # This method requires {Resource#auth auth} to return an
-      # authenticated instance of {Yt::Account}.
-      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} does not
-      #   return an authenticated account.
-      def subscribe
-        subscriptions.insert(ignore_errors: true).tap do |subscription|
-          throttle_subscriptions
-          @subscription = subscription
-        end
+    ### ACTIONS (UPLOAD, UPDATE, DELETE) ###
+
+      # Deletes the channel’s playlists matching all the given attributes.
+      # @return [Array<Boolean>] whether each playlist matching the given
+      #   attributes was deleted.
+      # @raise [Yt::Errors::RequestError] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account with permissions to update the channel.
+      # @param [Hash] attributes the attributes to match the playlists by.
+      # @option attributes [<String, Regexp>] :title The playlist’s title.
+      #   Pass a String for perfect match or a Regexp for advanced match.
+      # @option attributes [<String, Regexp>] :description The playlist’s
+      #   description. Pass a String (perfect match) or a Regexp (advanced).
+      # @option attributes [Array<String>] :tags The playlist’s tags.
+      #   All tags must match exactly.
+      # @option attributes [String] :privacy_status The playlist’s privacy
+      #   status.
+      def delete_playlists(attributes = {})
+        playlists.delete_all attributes
       end
 
-      def delete_playlists(attrs = {})
-        playlists.delete_all attrs
+    ### PRIVATE API ###
+
+      # @private
+      # Override Resource's new to set statistics as well
+      # if the response includes them
+      def initialize(options = {})
+        super options
+        if options[:statistics]
+          @statistics_set = StatisticsSet.new data: options[:statistics]
+        end
+        if options[:content_owner_details]
+          @content_owner_detail = ContentOwnerDetail.new data: options[:content_owner_details]
+        end
       end
 
       # @private