yt 0.17.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be6a02a5308ac5e0d87af25b8f92842fb7474e10
-  data.tar.gz: 65bd602aebf8bae1bad8dfec257a733f4b3aebfb
+  metadata.gz: 9b9767e99d417362ada2195c0d52a9a739a0ead3
+  data.tar.gz: c73d616d817e5c08a67fe6e82bd4192060175c36
 SHA512:
-  metadata.gz: 1f77000f204e230668a04045f2216d93a589b55819528851d5aeb855eafb60901eba702a00fe7608b719529d65e66a0e87ac176b097f637b8e0e492e5930bd6d
-  data.tar.gz: 076a1006983c59b30fa5abd80d0c1ec6d9073db27c826b6f656a436331ff822ef3c0be6087e3a14c22f2d281793414b9906d7293f29230414ec6684711c56e8c
+  metadata.gz: 81cf574551196ee465e708561ad151c1c095d5348c537fadcb6cf7fca6ffe085e0dec832e712263146106f6a43657879171a058eba3fc9fa186dda0015b3580a
+  data.tar.gz: af7747988d6d86dc5cc51b3442c018d344ff6ca12bd8612c462d2fdd778e036e70c2dde22d2f2220add7d8dbf08877ffa7ac04f900375419d2469828a821506c

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.18.0 - 2015-04-28
+
+**How to upgrade**
+
+If your code never calls `public?`, `private?` or `unlisted?` on a Status
+object, then you are good to go.
+
+If it does, then call the same methods on the parent Resource object instead.
+For instance, replace `video.status.private?` with `video.private?`.
+
+* [ENHANCEMENT] Don’t over-delegate privacy status methods of Resource.
+
 ## 0.17.0 - 2015-04-28
 
 **How to upgrade**

data/README.md

@@ -3,13 +3,13 @@ Yt - a Ruby client for the YouTube API
 
 Yt helps you write apps that need to interact with YouTube.
 
-The **full documentation** is available at [rubydoc.info](http://rubydoc.info/github/Fullscreen/yt/master/frames).
+The **full documentation** is available at [rubydoc.info](http://www.rubydoc.info/gems/yt/frames).
 
 [![Build Status](http://img.shields.io/travis/Fullscreen/yt/master.svg)](https://travis-ci.org/Fullscreen/yt)
 [![Coverage Status](http://img.shields.io/coveralls/Fullscreen/yt/master.svg)](https://coveralls.io/r/Fullscreen/yt)
 [![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/yt.svg)](https://gemnasium.com/Fullscreen/yt)
 [![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/yt.svg)](https://codeclimate.com/github/Fullscreen/yt)
-[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://rubydoc.info/github/Fullscreen/yt/master/frames)
+[![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://www.rubydoc.info/gems/yt/frames)
 [![Gem Version](http://img.shields.io/gem/v/yt.svg)](http://rubygems.org/gems/yt)
 
 After [registering your app](#configuring-your-app), you can run commands like:
@@ -30,7 +30,7 @@ video.hd? #=> true
 video.annotations.count #=> 1
 ```
 
-The **full documentation** is available at [rubydoc.info](http://rubydoc.info/github/Fullscreen/yt/master/frames).
+The **full documentation** is available at [rubydoc.info](http://www.rubydoc.info/gems/yt/frames).
 
 How to install
 ==============
@@ -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.17.0'
+    gem 'yt', '~> 0.18.0'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -54,7 +54,7 @@ Available resources
 Yt::Account
 -----------
 
-Use [Yt::Account](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Account) to:
+Use [Yt::Account](http://www.rubydoc.info/gems/yt/Yt/Models/Account) to:
 
 * authenticate as a YouTube account
 * read the attributes of the account
@@ -99,7 +99,7 @@ account.content_owners.first #=>  #<Yt::Models::ContentOwner @id=...>
 Yt::ContentOwner
 ----------------
 
-Use [Yt::ContentOwner](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/ContentOwner) to:
+Use [Yt::ContentOwner](http://www.rubydoc.info/gems/yt/Yt/Models/ContentOwner) to:
 
 * authenticate as a YouTube content owner
 * list the channels partnered with a YouTube content owner
@@ -140,7 +140,7 @@ content_owner.create_asset type: 'web' #=> #<Yt::Models::Asset @id=...>
 Yt::Channel
 -----------
 
-Use [Yt::Channel](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Channel) to:
+Use [Yt::Channel](http://www.rubydoc.info/gems/yt/Yt/Models/Channel) to:
 
 * read the attributes of a channel
 * access the videos of a channel
@@ -292,7 +292,7 @@ channel.linked_at #=> Wed, 28 May 2014
 Yt::Video
 -----------
 
-Use [Yt::Video](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Video) to:
+Use [Yt::Video](http://www.rubydoc.info/gems/yt/Yt/Models/Video) to:
 
 * read the attributes of a video
 * update the attributes of a video
@@ -472,7 +472,7 @@ video.ad_formats #=> ["standard_instream", "trueview_instream"]
 Yt::Playlist
 ------------
 
-Use [Yt::Playlist](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Playlist) to:
+Use [Yt::Playlist](http://www.rubydoc.info/gems/yt/Yt/Models/Playlist) to:
 
 * read the attributes of a playlist
 * update the attributes of a playlist
@@ -526,7 +526,7 @@ playlist.views_per_playlist_start since: 7.days.ago #=> {Wed, 28 May 2014 => 12.
 Yt::PlaylistItem
 ----------------
 
-Use [Yt::PlaylistItem](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/PlaylistItem) to:
+Use [Yt::PlaylistItem](http://www.rubydoc.info/gems/yt/Yt/Models/PlaylistItem) to:
 
 * read the attributes of a playlist item
 * update the position of an item inside a playlist
@@ -562,7 +562,7 @@ item.delete #=> true
 Yt::Collections::Videos
 -----------------------
 
-Use [Yt::Collections::Videos](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Collections/Videos) to:
+Use [Yt::Collections::Videos](http://www.rubydoc.info/gems/yt/Yt/Collections/Videos) to:
 
 * search for videos
 
@@ -580,7 +580,7 @@ videos.where(id: 'MESycYJytkU,invalid').map(&:title) #=> ["Fullscreen Creator Pl
 Yt::Annotation
 --------------
 
-Use [Yt::Annotation](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Annotation) to:
+Use [Yt::Annotation](http://www.rubydoc.info/gems/yt/Yt/Models/Annotation) to:
 
 * read the attributes of an annotation
 
@@ -598,7 +598,7 @@ annotation.has_link_to_playlist? #=> true
 Yt::MatchPolicy
 ---------------
 
-Use [Yt::MatchPolicy](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/MatchPolicy) to:
+Use [Yt::MatchPolicy](http://www.rubydoc.info/gems/yt/Yt/Models/MatchPolicy) to:
 
 * update the policy used by an asset
 
@@ -611,7 +611,7 @@ match_policy.update policy_id: 'aBcdEF6g-HJ' #=> true
 Yt::Asset
 ---------
 
-Use [Yt::Asset](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Asset) to:
+Use [Yt::Asset](http://www.rubydoc.info/gems/yt/Yt/Models/Asset) to:
 
 * read the ownership of an asset
 * update the attributes of an asset
@@ -632,7 +632,7 @@ asset.update metadata_mine: {notes: 'Some notes'} #=> true
 Yt::Claim
 ---------
 
-Use [Yt::Claim](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Claim) to:
+Use [Yt::Claim](http://www.rubydoc.info/gems/yt/Yt/Models/Claim) to:
 
 * read the attributes of a claim
 * view the history of a claim
@@ -658,7 +658,7 @@ claim.delete #=> true
 Yt::Ownership
 -------------
 
-Use [Yt::Ownership](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/Ownership) to:
+Use [Yt::Ownership](http://www.rubydoc.info/gems/yt/Yt/Models/Ownership) to:
 
 * update the ownership of an asset
 
@@ -674,7 +674,7 @@ ownership.update general: [new_general_owner_attrs]
 Yt::AdvertisingOptionsSet
 -------------------------
 
-Use [Yt::AdvertisingOptionsSet](http://rubydoc.info/github/Fullscreen/yt/master/Yt/Models/AdvertisingOptionsSet) to:
+Use [Yt::AdvertisingOptionsSet](http://www.rubydoc.info/gems/yt/Yt/Models/AdvertisingOptionsSet) to:
 
 * update the advertising settings of a video
 

data/lib/yt/associations/has_reports.rb

@@ -16,7 +16,7 @@ module Yt
 
       # @!macro [new] daily_report
       #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
-      #     Valid values are: +:day+.
+      #     Accepted values are: +:day+.
       #   @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:
@@ -26,8 +26,8 @@ module Yt
 
       # @!macro [new] views_report
       #   @option options [Symbol] :by (:day) The dimension to collect $1 by.
-      #     Valid values are: +:day+, +:traffic_source+, +:playback_location+,
-      #     +:embedded_player_location+, +:related_video+.
+      #     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:
@@ -58,7 +58,7 @@ module Yt
       # @!macro [new] demographics_report
       #   @option options [Symbol] :by (:gender_age_group) The dimension to
       #     show viewer percentage by.
-      #     Valid values are: +:gender+, +:age_group+, +:gender_age_group+.
+      #     Accepted values are: +:gender+, +:age_group+, +:gender_age_group+.
       #   @return [Hash<Symbol, Float>] if grouped by gender, the video’s
       #     viewer percentage by gender.
       #   @example Get yesterday’s video’s viewer percentage by gender:

data/lib/yt/associations/has_viewer_percentages.rb

@@ -15,12 +15,6 @@ module Yt
       #       '25-34', '35-44', '45-54', '55-64', '65-')
       #     @example Return the % of male viewers of a channel older than 64
       #       channel.viewer_percentages[:male]['65-'] #=> 12.02
-      #   @!method viewer_percentage(filters = {})
-      #     @return [Float] the percentage of viewer matching the filters.
-      #     @param [Hash] filters The type of viewers to be accounted for.
-      #     @option filters [Symbol] :gender Either :male or :female.
-      #     @example Return the % of male viewers of a video
-      #       channel.viewer_percentage(gender: :male) #=> 52.02
 
       # Defines one public instance methods to access the viewer percentages of
       # a resource for a specific metric.

data/lib/yt/models/asset.rb

@@ -53,14 +53,15 @@ module Yt
       #   identify the asset.
       has_attribute :id
 
+      # Returns the asset’s type.
       # @return [String] the asset’s type. This value determines the metadata
       #   fields that you can set for the asset. In addition, certain API
       #   functions may only be supported for specific types of assets. For
       #   example, composition assets may have more complex ownership data than
       #   other types of assets.
-      #   Valid values for this property are: art_track_video, composition,
-      #   episode, general, movie, music_video, season, show, sound_recording,
-      #   video_game, and web.
+      #   Possible values are: +'art_track_video'+, +'composition'+,
+      #   +'episode'+, +'general'+, +'movie'+, +'music_video'+, +'season'+,
+      #   +'show'+, +'sound_recording'+, +'video_game'+, +'web'+.
       has_attribute :type
 
       # @return [Array<Yt::Models::Tag>] the list of asset labels associated
@@ -73,8 +74,9 @@ module Yt
 
       STATUSES = %q(active inactive pending)
 
-      # @return [String] the asset’s status. Valid values are: active,
-      #   inactive, and pending.
+      # Returns the asset’s status.
+      # @return [String] the asset’s status. Possible values are: +'active'+,
+      #   +'inactive'+, +'pending'+.
       # @note Despite what the documentation says, YouTube API never returns
       #   the status of an asset, so it’s impossible to update, although the
       #   documentation says this should be the case. If YouTube ever fixes

data/lib/yt/models/asset_snippet.rb

@@ -16,14 +16,15 @@ module Yt
       #   identify the asset.
       has_attribute :id
 
+      # Returns the asset’s type.
       # @return [String] the asset’s type. This value determines the metadata
       #   fields that you can set for the asset. In addition, certain API
       #   functions may only be supported for specific types of assets. For
       #   example, composition assets may have more complex ownership data than
       #   other types of assets.
-      #   Valid values for this property are: art_track_video, composition,
-      #   episode, general, movie, music_video, season, show, sound_recording,
-      #   video_game, and web.
+      #   Possible values are: +'art_track_video'+, +'composition'+,
+      #   +'episode'+, +'general'+, +'movie'+, +'music_video'+, +'season'+,
+      #   +'show'+, +'sound_recording'+, +'video_game'+, +'web'+.
       has_attribute :type
 
       # @return [String] the title of this asset.

data/lib/yt/models/claim.rb

@@ -45,8 +45,10 @@ module Yt
       STATUSES = %q(active appealed disputed inactive pending potential
         takedown unknown)
 
-      # @return [String] the claim’s status. Valid values are: active,
-      #   appealed, disputed, inactive, pending, potential, takedown, unknown.
+      # Returns the claim’s status.
+      # @return [String] the claim’s status. Possible values are: +'active'+,
+      #   +'appealed'+, +'disputed'+, +'inactive'+, +'pending'+, +'potential'+,
+      #   +'takedown'+, +'unknown'+.
       # @note When updating a claim, you can update its status from active to
       #   inactive to effectively release the claim, but the API does not
       #   support other updates to a claim’s status.
@@ -96,22 +98,22 @@ module Yt
 
       CONTENT_TYPES = %q(audio video audiovisual)
 
-      # @return [String] whether the claim covers the audio, video, or
-      #   audiovisual portion of the claimed content. Valid values are: audio,
-      #   audiovisual, video.
+      # Returns the audiovisual portion of the claimed content.
+      # @return [String] the audiovisual portion of the claimed content.
+      #   Possible values are: +'audio'+, +'audiovisual'+, +'video'+.
       has_attribute :content_type
 
-      # @return [Boolean] whether the covers the audio of the content.
+      # @return [Boolean] whether the claim covers only the audio.
       def audio?
         content_type == 'audio'
       end
 
-      # @return [Boolean] whether the covers the video of the content.
+      # @return [Boolean] whether the claim covers only the video.
       def video?
         content_type == 'video'
       end
 
-      # @return [Boolean] whether the covers the audiovisual of the content.
+      # @return [Boolean] whether the claim covers both audio and video.
       def audiovisual?
         content_type == 'audiovisual'
       end

data/lib/yt/models/policy_rule.rb

@@ -15,14 +15,13 @@ module Yt
 
       # Return the policy that YouTube should enforce if the rule’s conditions
       # are all valid for an asset or for an attempt to view that asset on
-      # YouTube. Valid values for this property are: block, monetize, takedown,
-      # track.
+      # YouTube. Possible values are: +'block'+, +'monetize'+, +'takedown'+,
+      # +'track'+.
       # @return [String] the policy that YouTube should enforce.
       has_attribute :action
 
-      # @return [Array] A list of additional actions that YouTube should take
-      #   if the conditions in the rule are met. Valid values for this property
-      #   are: review.
+      # @return [Array] A list of additional actions that YouTube should take if
+      #   the conditions in the rule are met. Possible values are: +'review'+.
       has_attribute :subaction
 
       # Return the list of territories where the policy applies.

data/lib/yt/models/rating.rb

@@ -7,7 +7,7 @@ module Yt
     # @see https://developers.google.com/youtube/v3/docs/videos/getRating
     class Rating < Base
       # @return [Symbol, nil] the rating of a video (if present).
-      #  Valid values are: :dislike, :like, :none, :unspecified
+      #  Possible values are: +:dislike+, +:like+, +:none+, +:unspecified+.
       attr_reader :rating
 
       def initialize(options = {})

data/lib/yt/models/reference.rb

@@ -85,11 +85,12 @@ module Yt
         duplicate_on_hold inactive live_streaming_processing
         urgent_reference_processing)
 
-      # @return [String] the reference’s status. Valid values are: activating,
-      #   active, checking, computing_fingerprint, deleted, duplicate_on_hold,
-      #   inactive, live_streaming_processing, and urgent_reference_processing.
+      # @return [String] the reference’s status. Possible values are:
+      #   +'activating'+, +'active'+, +'checking'+, +'computing_fingerprint'+,
+      #   +'deleted'+, +'duplicate_on_hold'+, +'inactive'+,
+      #   +'live_streaming_processing'+, +'urgent_reference_processing'+.
       has_attribute :status
-      
+
       # @return [Boolean] whether the reference is pending.
       def activating?
         status == 'activating'
@@ -142,25 +143,22 @@ module Yt
 
       CONTENT_TYPES = %q(audio video audiovisual)
 
-      # @return [String] whether the reference covers the audio, video, or
-      #   audiovisual portion of the claimed content. Valid values are: audio,
-      #   audiovisual, video.
+      # Returns the audiovisual portion of the referenced content.
+      # @return [String] the audiovisual portion of the referenced content.
+      #   Possible values are: +'audio'+, +'audiovisual'+, +'video'+.
       has_attribute :content_type
 
-      # @return [Boolean] whether the reference covers the audio of the
-      #   content.
+      # @return [Boolean] whether the reference covers only the audio.
       def audio?
         content_type == 'audio'
       end
 
-      # @return [Boolean] whether the reference covers the video of the
-      #   content.
+      # @return [Boolean] whether the reference covers only the video.
       def video?
         content_type == 'video'
       end
 
-      # @return [Boolean] whether the reference covers the audiovisual of the
-      #   content.
+      # @return [Boolean] whether the reference covers both audio and video.
       def audiovisual?
         content_type == 'audiovisual'
       end

data/lib/yt/models/resource.rb

@@ -8,17 +8,39 @@ module Yt
     class Resource < Base
       attr_reader :auth
 
+    ### ID ###
+
       # @!attribute [r] id
       #   @return [String] the ID that YouTube uses to identify each resource.
       has_one :id
 
+    ### STATUS ###
+
+      has_one :status
+
+      # @return [String] the privacy status of the resource. Possible values
+      #   are: +'private'+, +'public'+, +'unlisted'+.
+      delegate :privacy_status, to: :status
+
+      # @return [Boolean] whether the resource is public.
+      def public?
+        privacy_status == 'public'
+      end
+
+      # @return [Boolean] whether the resource is private.
+      def private?
+        privacy_status == 'private'
+      end
+
+      # @return [Boolean] whether the resource is unlisted.
+      def unlisted?
+        privacy_status == 'unlisted'
+      end
+
       has_one :snippet
       delegate :title, :description, :thumbnail_url, :published_at,
         to: :snippet
 
-      has_one :status
-      delegate :privacy_status, :public?, :private?, :unlisted?, to: :status
-
       def initialize(options = {})
         @url = URL.new(options[:url]) if options[:url]
         @id = options[:id] || (@url.id if @url)
@@ -47,9 +69,11 @@ module Yt
         end
       end
 
-
     private
 
+      # TODO: instead of having Video, Playlist etc override this method,
+      #       they should define *what* can be updated in their own *update*
+      #       method.
       # @return [Hash] the parameters to submit to YouTube to update a playlist.
       # @see https://developers.google.com/youtube/v3/docs/playlists/update
       # @see https://developers.google.com/youtube/v3/docs/videos/update

data/lib/yt/models/status.rb

@@ -22,25 +22,7 @@ module Yt
 
       PRIVACY_STATUSES = %q(private public unlisted)
 
-      # @return [String] the privacy status of the resource. Valid values are:
-      #   private, public, unlisted.
       has_attribute :privacy_status
-
-      # @return [Boolean] whether the resource is public.
-      def public?
-        privacy_status == 'public'
-      end
-
-      # @return [Boolean] whether the resource is private.
-      def private?
-        privacy_status == 'private'
-      end
-
-      # @return [Boolean] whether the resource is unlisted.
-      def unlisted?
-        privacy_status == 'unlisted'
-      end
-
       has_attribute :upload_status
       has_attribute :failure_reason
       has_attribute :rejection_reason

data/lib/yt/models/user_info.rb

@@ -34,7 +34,7 @@ module Yt
       has_attribute :avatar_url, from: :picture, default: ''
 
       # @return [String] the person’s gender. Possible values include, but
-      #   are not limited to, "male", "female", "other".
+      #   are not limited to, +'male'+, +'female'+, +'other'+.
       has_attribute :gender, default: ''
 
       # @return [String] the user’s preferred locale.

data/lib/yt/models/video.rb

@@ -9,13 +9,11 @@ module Yt
   ### SNIPPET ###
 
       # @!attribute [r] title
-      # @return [String] the video’s title. Has a maximum of 100 characters and
-      #   may contain all valid UTF-8 characters except < and >.
+      # @return [String] the video’s title.
       delegate :title, to: :snippet
 
       # @!attribute [r] description
-      # @return [String] the video’s description. Has a maximum of 5000 bytes
-      #   and may contain all valid UTF-8 characters except < and >.
+      # @return [String] the video’s description.
       delegate :description, to: :snippet
 
       # Return the URL of the video’s thumbnail.
@@ -41,11 +39,10 @@ module Yt
 
       # @!attribute [r] live_broadcast_content
       # @return [String] the type of live broadcast that the video contains.
-      #   Valid values are: live, none, upcoming.
+      #   Possible values are: +'live'+, +'none'+, +'upcoming'+.
       delegate :live_broadcast_content, to: :snippet
 
-      # @return [Array<Yt::Models::Tag>] the list of tags attached to the video.
-      #   with the video.
+      # @return [Array<String>] the list of tags attached to the video.
       def tags
         ensure_complete_snippet :tags
       end
@@ -196,8 +193,8 @@ module Yt
       end
 
       # @!attribute [r] license
-      # @return [String] the video’s license.
-      #   Valid values are: creativeCommon, youtube.
+      # @return [String] the video’s license. Possible values are:
+      #   +'creativeCommon'+, +'youtube'+.
       delegate :license, to: :status
 
       # @return [Boolean] whether the video uses the Standard YouTube license.
@@ -222,7 +219,7 @@ module Yt
         status.public_stats_viewable
       end
 
-      # @return [Boolean] whether the video can be embedded on another website.
+      # @return [Boolean] whether the video can be embedded on other websites.
       def embeddable?
         status.embeddable
       end
@@ -328,8 +325,9 @@ module Yt
 
       # @!attribute [r] ad_formats
       # @return [Array<String>] the list of ad formats that the video is
-      #   allowed to show. Valid values are: long, overlay,
-      #   standard_instream, third_party, trueview_inslate, trueview_instream.
+      #   allowed to show. Possible values are: +'long'+, +'overlay'+,
+      #   +'standard_instream'+, +'third_party'+, +'trueview_inslate'+,
+      #   +'trueview_instream'+.
       delegate :ad_formats, to: :advertising_options_set
 
 
@@ -465,7 +463,7 @@ module Yt
       # @return [Integer] the number of users who marked the video as favorite.
       delegate :favorite_count, to: :statistics_set
 
-      # @!attribute [r] dislike_count
+      # @!attribute [r] comment_count
       # @return [Integer] the number of comments for the video.
       delegate :comment_count, to: :statistics_set
 
@@ -507,6 +505,44 @@ module Yt
         !exists?
       end
 
+      # Updates the attributes of a video.
+      # @return [Boolean] whether the video was successfully updated.
+      # @raise [Yt::Errors::Unauthorized] if {Resource#auth auth} is not an
+      #   authenticated Yt::Account with permissions to update the video.
+      # @param [Hash] attributes the attributes to update.
+      # @option attributes [String] :title The new video’s title.
+      #   Cannot have more than 100 characters. Can include the characters
+      #   < and >, which are replaced to ‹ › in order to be accepted by YouTube.
+      # @option attributes [String] :description The new video’s description.
+      #   Cannot have more than 5000 bytes. Can include the characters
+      #   < and >, which are replaced to ‹ › in order to be accepted by YouTube.
+      # @option attributes [Array<String>] :tags The new video’s tags.
+      #   Cannot have more than 500 characters. Can include the characters
+      #   < and >, which are replaced to ‹ › in order to be accepted by YouTube.
+      # @option attributes [String] :category_id The new video’s category ID.
+      # @option attributes [String] :privacy_status The new video’s privacy
+      #   status. Must be one of: private, unscheduled, public.
+      # @option attributes [Boolean] :embeddable The new value to specify
+      #   whether the video can be embedded on other websites.
+      # @option attributes [String] :license The new video’s license. Must be
+      #   one of: youtube, creativeCommon.
+      # @option attributes [Boolean] :public_stats_viewable The new value to
+      #   specify whether the video’s statistics are publicly viewable.
+      # @option attributes :publish_at The new timestamp when the video will be
+      #   made public. Must be in ISO 8601 format (YYYY-MM-DDThh:mm:ss.sZ).
+      # @example Update title and description of a video.
+      #   video.update title: 'New title', description: 'New description'
+      # @example Update tags and category ID of a video.
+      #   video.update tags: ['new', 'tags'], category_id: '22'
+      # @example Update status of a video.
+      #   video.update privacy_status: 'public', public_stats_viewable: true
+      # @example Update visibility/license of a video.
+      #   video.update embeddable: true, license: :youtube
+      # @example Update the time when a private video will become public.
+      #   video.update publish_at: 3.days.from_now.utc.iso8601(3)
+      def update(attributes = {})
+        super
+      end
 
     ### PRIVATE API ###
 
@@ -587,6 +623,9 @@ module Yt
         snippet.public_send attribute
       end
 
+      # TODO: instead of having Video, Playlist etc override this method,
+      #       they should define *what* can be updated in their own *update*
+      #       method.
       # @see https://developers.google.com/youtube/v3/docs/videos/update
       # @todo: Add recording details keys
       def update_parts

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.17.0'
+  VERSION = '0.18.0'
 end

data/spec/models/resource_spec.rb

@@ -18,4 +18,40 @@ describe Yt::Resource do
     it { expect(resource.kind).to eq 'channel' }
     it { expect(resource.username).to eq 'fullscreen' }
   end
+
+  describe '#public?' do
+    context 'given fetching a status returns privacyStatus "public"' do
+      let(:attrs) { {status: {"privacyStatus"=>"public"}} }
+      it { expect(resource).to be_public }
+    end
+
+    context 'given fetching a status does not return privacyStatus "public"' do
+      let(:attrs) { {status: {}} }
+      it { expect(resource).not_to be_public }
+    end
+  end
+
+  describe '#private?' do
+    context 'given fetching a status returns privacyStatus "private"' do
+      let(:attrs) { {status: {"privacyStatus"=>"private"}} }
+      it { expect(resource).to be_private }
+    end
+
+    context 'given fetching a status does not return privacyStatus "private"' do
+      let(:attrs) { {status: {}} }
+      it { expect(resource).not_to be_private }
+    end
+  end
+
+  describe '#unlisted?' do
+    context 'given fetching a status returns privacyStatus "unlisted"' do
+      let(:attrs) { {status: {"privacyStatus"=>"unlisted"}} }
+      it { expect(resource).to be_unlisted }
+    end
+
+    context 'given fetching a status does not return privacyStatus "unlisted"' do
+      let(:attrs) { {status: {}} }
+      it { expect(resource).not_to be_unlisted }
+    end
+  end
 end

data/spec/models/status_spec.rb

@@ -10,40 +10,4 @@ describe Yt::Status do
       expect(status.data).to eq data
     end
   end
-
-  describe '#public?' do
-    context 'given fetching a status returns privacyStatus "public"' do
-      let(:data) { {"privacyStatus"=>"public"} }
-      it { expect(status).to be_public }
-    end
-
-    context 'given fetching a status does not return privacyStatus "public"' do
-      let(:data) { {} }
-      it { expect(status).not_to be_public }
-    end
-  end
-
-  describe '#private?' do
-    context 'given fetching a status returns privacyStatus "private"' do
-      let(:data) { {"privacyStatus"=>"private"} }
-      it { expect(status).to be_private }
-    end
-
-    context 'given fetching a status does not return privacyStatus "private"' do
-      let(:data) { {} }
-      it { expect(status).not_to be_private }
-    end
-  end
-
-  describe '#unlisted?' do
-    context 'given fetching a status returns privacyStatus "unlisted"' do
-      let(:data) { {"privacyStatus"=>"unlisted"} }
-      it { expect(status).to be_unlisted }
-    end
-
-    context 'given fetching a status does not return privacyStatus "unlisted"' do
-      let(:data) { {} }
-      it { expect(status).not_to be_unlisted }
-    end
-  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Claudio Baccigalupo