yt 0.9.7 → 0.9.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fe0377f41d87e871a3db2e1380356bc53f788fa5
-  data.tar.gz: 8943b3e3187efbe011d4c73b56882daea6d1f94f
+  metadata.gz: db90684e975d4957dfb63d6ae4dd5a7c4b48749c
+  data.tar.gz: a49f7815ae7a37e73ac6e26cb9f12cee97a011d2
 SHA512:
-  metadata.gz: 0825f5187597673a1467626df427092c874961c29b0c8f888dddc424d28a99afedaba755719a1f713e9694a9bb38762e9709d9fa6b4759af0fe83127e17af088
-  data.tar.gz: 6b0a8ab02e131601d729f6b3be3dc97464fe8c4c51f19cf7afac602fa33507b9fdd4ef45f72a2755fba4b27c220b605453969628803a6778d4e67a8d00016eba
+  metadata.gz: 109d5c7feb5b3f1664b5f45a5618cbcbc75cda94cd44e7b0c7f86881ff9cbdf3959fffe2accdbcc1c6ae91bd5bf5f1173752c7a98a5eb5b83f85cfdafe6491fb
+  data.tar.gz: 49efcf9203a7f65e44aa28a498c860b6bde0afe64dbf648fcc9ab9d525dcfe968103238af05e70b855d6002523db3dc6a39683b49750c431ed394c534df160b8

data/.travis.yml

@@ -5,27 +5,5 @@ matrix:
   include:
   - rvm: 1.9.3
     gemfile: gemfiles/Gemfile.activesupport-3.x
-    env:
-    - secure: OsmWyhhYNILEb1lhqxPX+iEfbWzC3dELuxQ7JGP9iN/FhqBtlV51cu+u2cBBdql6Gzuqi4VlMEeJSX0PQUmzOsMb0vHhOJDyp4a32NE+xry8LOT8XdCwni20ZBcUeFxC5hMUVebPuhqBTFjBWbXQKwKSXIdPnNWz31d9kyGIsxk=
   - rvm: 2.0.0
-    gemfile: gemfiles/Gemfile.activesupport-4.x
-    env:
-    - secure: FrmFA2BE0FYyuKsf0FEO0EAXY+h048HbD1p3lu5XPo9/lxpAl7wM5m12HsnJQuNY6UlUmZ5bp9f8upCBZpz7cLZK5e/FWLWSvkv3Fts+NVsbAcVtFgvBKOCgTznZi/qgUtqbWBevkM3gyXyylzdB+c4wWjoOO/xSDVR227m8nMA=
-env:
-  global:
-  - secure: ApPj5c9h6xk+AbHHf4KXL10QnleYCWwcp2+qMFolrS6RWR5vhrnKq1UBo0h59HuvXeOQIgZ/GmocuSEZovS9c1hQP3n0PHSNEnGUNJyn6CS3BiPQSWmC3p2pONo1Xv+hVWfzDoEv80b82GX5P5x/l1BSqhpxLA9geITJprWsoLg=
-  - secure: CkLyqIq/yTV5h/41b0wxIhMN0LvTk51IBht1+l678YSK7zT9emo9DcwnZVQ9f9KluDD8SyUGRORD40eQs8XmqpDCx7gj7i5e3TEVBofM9YnyFMR1lsWRiMr8jf2eksuP10kEkV7S7E1KH4LI2K1ZcOVqfN0G3Vs0C5D8GwpEcQ8=
-  - secure: XzuEz0AV6eDeT3+VaodXRMOh+fDvtG1X/VDfnh3f3gmVsnW1d8gdZY9Gw9rkSixK0SwL58BcSu+SU9BlDAsa0asv2XF8h51Q7s3x0ld9I60ssV/4DXSXqicHYcq13Vd86JMmURUuLiJM3y5lXb0bMGXNOkgYZ19gd5X9No+Tkww=
-  - secure: GvFLpteuIhPHtNT41VBR49sJf5yAWpwwGA24Ov92e5FaVzZD8eiBQZYwjx3Whyo5nkSN5nDzYeKvEdkHaE+sIhSjhoeSY6Q85YK9o/4hSSxjo71OepZXfawKH0xtpkbI+N1fMuUCZR0ustSCLx1snLLZtFRQR2YWU6qg+Yj48Ds=
-  - secure: d7yJZSz7Xk0LgJJSTbiK+yb12fdu9101wGXR56sSaRb5BoulBO12uKQgMYMa1kAh6imrNL4WzGOQQGC3SXDAEL6riHcuQJQOmM5zRJtZOrgitVe4cUm9Lv7jo4OyoJNd65EqpOaFPlI0Z3hp0xy3tOuTXemjie44ReKsCUp7z2Y=
-  - secure: Hpv62bpHo2zNHwB6VYNKxXLv12GHC0fiGUZ/uDv/4ncukifR9zEeucp104o3f4jqRpauy533kNw1JmucXI6Y+IEyHoEcqA99/i/HirS5WlB7vRH1ATX20Jj3kQ2JaFBIzidX9gNXvSNwpI2XK267eqfZUDFU8zp6aUPnJ6tgpq0=
-  - secure: Ejj8tsuwyrRVmCc/R9ubKWCHWhCGpe0Dy6fc1UuPCkcMZyXq9ZC02v2obWsTQQ7epEgsCYZAO4v/gWpuv1b1huGcWdfJzMW7RCoY87cEf9HnAK0lSwGx4+/pYkEMe8y5p149C3vAR8nqczvEavN1fUq/WwPUqp+JyDP7kwFTs2Y=
-  - secure: gE5kAT1R54hmS+W3YYGcUtlD8ZskvTctVR3sr+C5CUjVPdq6Ktx5Q/a6EJyAVVrhxpaCOuk3LG+VkzdQIVFUNRiDPcOulkond4HkSQDoy+IJ/wTXvUS+lIJ1ERUnWega+APrQUjH5s2WayPGZUBqWt/u8Tt9EmSUZfuKZSEXqZk=
-  - secure: ZUx5v/wHW/TENg8NfFINiiMoe2D031ntDTiuIBdf88c/bMClkEtRRgomtK9RBkFonEyGEOkXxUm2SLzRf340V3eIXWQhil7ab1lcYs8X59aVS/NK/GqChH8Nia17gc3OTQ9k6rYvj4Lp60Dh9WG1cijLPd4/OvPmf6qX9uYfJMw=
-  - secure: DumQVO01Y3Ki1skuOYOZzosDb6jS0XyG1O8Agy3mVxXGJzQE+s1z2UFz4gMpsU9o/gmiNMddp7I6+RtbZjo9hN3H7vlRRwEeB7tuUMiDyomSx1FlHcCFfPdTmhxGg8X78SErMWqNC6eReGrCTgBdIq1ho7dIu53qJNxTEFqx7eI=
-  - secure: UCceSRqPe5Y8WCM85qj0i8wlB5gJRSegJZfVj5jnwyermcOc1ZucwDZwTzkYVbLfDGTqTqzqW6M322a1tWm74xeIbxuHG7fw3Waoxk4zh3tg1CmNkzeDZFnl6V10uOMT6pn5E3kfhLzqOzftJN6fTMCgYMdkwJcfdrMX+z1cxwM=
-  - secure: QIOy4cACShEuU96BRBC4IdFFbi9Dr58wdFF25q3Tb1FXHQCxeOINF6tGuHsEBa04dNVLsZFCIbP+1mP2li8W40eSxg0PXd5r61mhR106dhBzN1ROX+EIP+mbecGCHgWIYVAtollSkCgHo9UBKUQOHavPnrvt1bTuV0eYvWiCZtc=
-  - secure: WICaR3cq/6SS4855tAJSZx0H/EkovfZZsxHY66y/lQ20p+DYJ0l6Jc6CRaZNvDPtj6Zp9Lu72CB2v6J2AO1WkrAvVBiMEj5zkPtVHwCcHxH0FasQCTFaLWy/zvcQeEIvidcBqABMsq1Pqv8p7UD8BRoQq22Vfe2LEjT/X2/eJwY=
-  - secure: E1ZoB5XyFxn3b9RVnXgt/JY+ikKLw57+CGcim0us8SdIwKctH8IWv0U7MggWATw2KtLgxEt1YU5MRFBxdO3nWY7XkvsYVCbLpmyFFzSDGZLNaaSLRZqon/N1lwias1pvOFL8cN2yLFXj6qMH67dBCyuQ1Q9LhejlWiGRBiLjfF8=
-  - secure: TnQ7HnvTM7pTwO0G7gYj+UjxxhPd0TOYAgHiafExrfr2nG+mkv1tc2OY/f1iB6kNp3+KEw+sNuyVZd1M9pFL93ARhla6FKqi/JoYFR0E2CxiVzAbLcabdtglqb8Jxw9a73YG7zFABZBWdTo5eR0TvpIK+rdTneUaEyCNU+Plh1E=
-  - secure: bZs3JaE02u3eS7hx7CXNZrUigSdYpbnKUdaHfNj7If0emfh15Tv6WaIszcKPVFUj1hMy6jeJcGJlAkYPA6iczLlmkD/1vzr75t1cNhXdCVq27uH3KWF6TN+/XsX1s4A29eIQTuHZ9q5qJyFyZVujqg1hvGjt0CSJYPxO+0muucE=
+    gemfile: gemfiles/Gemfile.activesupport-4.x

data/{HISTORY.md → CHANGELOG.md}

@@ -1,28 +1,137 @@
-v0.9 - 2014/07/28
------------------
-
-* [breaking change] Rename rating.update to rating.set
-* Add content_owner.references to retrieve ContentID references
-* Add content_owner.policies to list ContentID policies
-* Let 'update' methods understand both under_score and camelCased parameters
-* Add claim.third_party?
-* Add actual_start_time, actual_end_time, scheduled_start_time, scheduled_end_time for live-streaming videos
-* Add privacy_status, public_stats_viewable, publish_at to the options that Video#update accepts
-* Allow angle brackets when editing title, description, tags and replace them with similar characters allowed by YouTube
-* Correctly parse duration of videos longer than 24 hours
-
-v0.8 - 2014/07/18
------------------
-
-* [breaking change] channel.subscribe returns nil (not raise an error) when trying to subscribe to your own channel
-* Add all the status fields to Video (upload status, failure reason, rejection reason, scheduled time, license, embeddable, public stats viewable)
-* Add content_owner.claims to list the claims administered by a content owner.
-* Allow content_owner.claims to be chained with .where, such as in account.videos.where(q: 'query')
-* Add account.content_owners to list content owners associated with an account
-* Add video.delete
-
-v0.7 - 2014/06/18
------------------
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+For more information about changelogs, check
+[Keep a Changelog](http://keepachangelog.com) and
+[Vandamme](http://tech-angels.github.io/vandamme).
+
+## 0.9.8 - 2014-08-11
+
+* [FEATURE] Add `.content_owner` and `.linked_at` to channels managed by a CMS content owner
+
+## 0.9.7 - 2014-08-02
+
+* [BUGFIX] Correctly parse videos’ duration for videos longer than 24 hours
+
+## 0.9.6 - 2014-08-02
+
+* [ENHANCEMENT] Accept angle brackets characters in videos’ and playlists’ metadata
+
+## 0.9.5 - 2014-08-02
+
+* [FEATURE] Allow status attributes of a video to be updated
+
+`video.update` now accepts three new attributes: `privacy_status`,
+`public_stats_viewable` and `publish_at`.
+
+## 0.9.4 - 2014-08-02
+
+* [FEATURE] Expose metadata for live-streaming videos
+
+New method are now available for `Video` instance to check their live-streaming
+details: `actual_start_time`, `actual_end_time`, `scheduled_start_time`,
+`scheduled_end_time` and `concurrent_viewers`.
+
+## 0.9.3 - 2014-07-30
+
+* [BUGFIX] Don’t cache `.where` conditions on multiple calls
+
+For instance, invoking `account.videos.where(q: 'x').count` followed by
+`account.videos.count` used to return the same result, because the `where`
+conditions of the first request were wrongly kept for the successive request.
+
+* [FEATURE] Check if a ContentID claim is third-party with `claim.third_party?`
+* [ENHANCEMENT] `update` methods accept both underscore and camel-case attributes
+
+For instance, either of the following syntaxes can now be used:
+`video.update categoryId: "22"` or `video.update category_id: "22"`.
+
+## 0.9.2 - 2014-07-29
+
+* [FEATURE] List ContentID policies with `content_owner.policies`
+
+## 0.9.1 - 2014-07-28
+
+* [FEATURE] List ContentID references with `content_owner.references`
+* [ENHANCEMENT] `playlist.update` accepts both `privacyStatus` and `privacy_status`
+
+For instance, either of the following syntaxes can now be used:
+`playlist.update privacyStatus: "unlisted"` or
+`playlist.update privacy_status: "unlisted"`.
+
+## 0.9.0 - 2014-07-28
+
+**How to upgrade**
+
+If your code never declares instances of `Yt::Rating`, or never calls the
+`update` method on them, then you are good to go.
+
+If it does, then *simply replace `update` with `set`*:
+
+```ruby
+rating = Yt::Rating.new
+# old syntax
+rating.update :like
+# new syntax
+rating.set :like
+```
+
+* [ENHANCEMENT] `rating.set` replaces `rating.update` to rate a video
+
+## 0.8.5 - 2014-07-28
+
+* [FEATURE] Delete a video with `video.delete`
+
+## 0.8.4 - 2014-07-24
+
+* [BUGFIX] Correctly parse annotations with timestamp written as `t='0'`
+
+## 0.8.3 - 2014-07-24
+
+* [FEATURE] List content owners managed by an account with `account.content_owners`
+
+## 0.8.2 - 2014-07-23
+
+* [FEATURE] List ContentID claims administered by a content owner with `content_owner.claims`
+
+## 0.8.1 - 2014-07-22
+
+* [FEATURE] Include all the video-related status information in `video.status`
+
+New method are now available for `Video` instance to check their status
+information: `public?`, `uploaded?`, `rejected?`, `failed?`, `processed?`,
+`deleted?`, `uses_unsupported_codec?`, `has_failed_conversion?`, `empty?`,
+`invalid?`, `too_small?`, `aborted?`, `claimed?`, `infringes_copyright?`,
+`duplicate?`, `inappropriate?`, `too_long?`, `belongs_to_closed_account?`,
+`infringes_trademark?`, `violates_terms_of_use?`, `has_public_stats_viewable?`,
+`belongs_to_suspended_account?`, `scheduled?`, `scheduled_at`, `embeddable?`
+`licensed_as_creative_commons?` and `licensed_as_standard_youtube?`.
+
+## 0.8.0 - 2014-07-19
+
+**How to upgrade**
+
+If your code never declares instances of `Yt::Channel`, or never calls the
+`subscribe` method on them, then you are good to go.
+
+If it does, then be aware that `subscribe` will not raise an error anymore if
+a YouTube user tries to subscribe to her/his own YouTube channel. Instead,
+`subscribe` will simply return `nil`. If this is acceptable, then you are good
+to go. If you want the old behavior, replace `subscribe` with `subscribe!`:
+
+```ruby
+account = Yt::Account.new access_token: 'ya29...'
+channel = account.channel
+# old behavior
+channel.subscribe # => raise error
+# new behavior
+channel.subscribe # => nil
+channel.subscribe! # => raise error
+```
+* [ENHANCEMENT] `channel.subscribe` does not raise error when trying to subscribe to one’s own channel
+
+## 0.7 - 2014/06/18
 
 * [breaking change] Rename DetailsSet to ContentDetail
 * Add statistics_set to Video (views, likes, dislikes, favorites, comments)
@@ -41,8 +150,7 @@ v0.7 - 2014/06/18
 * Make channel.videos access more than 500 videos per channel
 * Add viewer percentage (age group, gender) to Channel and Video reports
 
-v0.6 - 2014/06/05
------------------
+## 0.6 - 2014/06/05
 
 * [breaking change] Rename Channel#earning to Channel#earnings_on
 * [breaking change] Account#videos shows *all* videos owned by account (public and private)
@@ -52,8 +160,7 @@ v0.6 - 2014/06/05
 * Handle annotations with "never" as the timestamp, without text, singleton positions, of private videos
 * New methods for Video: hd?, stereoscopic?, captioned?, licensed?
 
-v0.5 - 2014/05/16
------------------
+## 0.5 - 2014/05/16
 
 * More complete custom exception Yt::Error, with code, body and curl
 * Replace `:ignore_not_found` and `:ignore_duplicates` with `:ignore_errors`
@@ -76,8 +183,7 @@ v0.5 - 2014/05/16
 * Wait 3 seconds and retry *every* request that returns 500, 503 or 400 with "Invalid query"
 * New Views collection to retrieve view count for YouTube-partnered channels
 
-v0.4 - 2014/05/09
---------------------
+## 0.4 - 2014/05/09
 
 * Complete rewrite, using ActiveSupport and separating models and collections
 * New methods to handle annotations, details sets
@@ -88,33 +194,28 @@ v0.4 - 2014/05/09
 * Allow to configure Yt credentials through environment variables
 * When updating a playlist, only changes the specified attributes
 
-v0.3.0 - 2014/04/16
---------------------
+## 0.3.0 - 2014/04/16
 
 * New and improved methods to handle subscriptions, playlists, playlist items
 * `find_or_create_playlist_by` does not yield a block anymore
 * `account.subscribe_to!` raises error in case of duplicate subscription, but `account.subscribe_to` does not
 
-v0.2.1 - 2014/04/10
---------------------
+## 0.2.1 - 2014/04/10
 
 * `account.subscribe_to!` does not raise error in case of duplicate subscription
 * Accountable objects can be initialized with the OAuth access token if there's no need to get a fresh one with a refresh token
 
-v0.2.0 - 2014/04/09
---------------------
+## 0.2.0 - 2014/04/09
 
 * Replaced `account.perform!` with `account.like!`, `account.subscribe_to!`
 * Added `account.add_to!` to add a video to an account’s playlist
 * Added `account.find_or_create_playlist_by` to find or create an account’s playlist
 
-v0.1.1 - 2014/04/09
---------------------
+## 0.1.1 - 2014/04/09
 
 * Added support for Ruby 2.0.0
 
-v0.1.0  - 2014/04/08
---------------------
+## 0.1.0  - 2014/04/08
 
 * Support for authenticated resources: Youtube accounts and Google accounts
 * Support for public Youtube resources: channels and videos

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    yt (0.9.7)
+    yt (0.9.8)
       activesupport
 
 GEM
@@ -21,27 +21,29 @@ GEM
       thor
     diff-lcs (1.2.5)
     docile (1.1.5)
-    i18n (0.6.9)
+    i18n (0.6.11)
     json (1.8.1)
     mime-types (2.3)
-    minitest (5.3.5)
+    minitest (5.4.0)
     multi_json (1.10.1)
+    netrc (0.7.7)
     rake (10.3.2)
-    rest-client (1.6.7)
-      mime-types (>= 1.16)
+    rest-client (1.7.2)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
     rspec (3.0.0)
       rspec-core (~> 3.0.0)
       rspec-expectations (~> 3.0.0)
       rspec-mocks (~> 3.0.0)
-    rspec-core (3.0.2)
+    rspec-core (3.0.3)
       rspec-support (~> 3.0.0)
-    rspec-expectations (3.0.2)
+    rspec-expectations (3.0.3)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.0.0)
-    rspec-mocks (3.0.2)
+    rspec-mocks (3.0.3)
       rspec-support (~> 3.0.0)
-    rspec-support (3.0.2)
-    simplecov (0.8.2)
+    rspec-support (3.0.3)
+    simplecov (0.9.0)
       docile (~> 1.1.0)
       multi_json
       simplecov-html (~> 0.8.0)

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.9.7'
+    gem 'yt', '~> 0.9.8'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -194,6 +194,9 @@ channel.impressions_on 5.days.ago #=> 157.0
 
 channel.viewer_percentages #=> {female: {'18-24' => 12.12, '25-34' => 16.16,…}…}
 channel.viewer_percentage(gender: :female) #=> 49.12
+
+channel.content_owner #=> 'FullScreen'
+channel.linked_at #=> Wed, 28 May 2014
 ```
 
 *The methods above require to be authenticated as the channel’s content owner (see below).*

data/Rakefile

@@ -5,19 +5,7 @@ Bundler::GemHelper.install_tasks
 require "rspec/core/rake_task"
 require "rspec/core/version"
 
-# desc "Run all examples"
-# RSpec::Core::RakeTask.new :spec
-
-# @note: During the last 48 hours, YouTube API has being responding with
-#   unexpected and undocumented errors to the content-owner endpoints.
-#   Since some pull requests are waiting for tests to pass on Travis CI and
-#   do not touch the content-owner component at all, those tests are
-#   temporarily skipped to allow those PRs to be accepted. This will cause
-#   code coverage to go down, but it's a temporary fix waiting for YouTube
-#   API to work again.
-desc "Run all examples except ones with access to Content Owner"
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.rspec_opts = '--tag ~partner --tag ~device_app'
-end
+desc "Run all examples"
+RSpec::Core::RakeTask.new :spec
 
 task default: [:spec]

data/lib/yt/collections/content_owner_details.rb

@@ -0,0 +1,36 @@
+require 'yt/collections/base'
+require 'yt/models/content_owner_detail'
+
+module Yt
+  module Collections
+    class ContentOwnerDetails < Base
+
+    private
+
+      # @return [Yt::Models::ContentOwnerDetail] a new content detail
+      #   initialized with one of the items returned by asking YouTube for a
+      #   list of them.
+      def new_item(data)
+        Yt::ContentOwnerDetail.new data: data['contentOwnerDetails']
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to get the
+      #   content owner detail of a channel.
+      # @see https://developers.google.com/youtube/v3/docs/channels#contentOwnerDetails
+      def list_params
+        super.tap do |params|
+          params[:params] = content_owner_details_params
+          params[:path] = '/youtube/v3/channels'
+        end
+      end
+
+      def content_owner_details_params
+        @parent.content_owner_details_params.tap do |params|
+          params[:max_results] = 50
+          params[:part] = 'contentOwnerDetails'
+          params[:id] = @parent.id
+        end
+      end
+    end
+  end
+end

data/lib/yt/models/channel.rb

@@ -47,6 +47,12 @@ module Yt
       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
+
       # Returns whether the authenticated account is subscribed to the channel.
       #
       # This method requires {Resource#auth auth} to return an
@@ -135,6 +141,15 @@ module Yt
           end
         end
       end
+
+      # @private
+      # Tells `has_one :content_owner_detail` to retrieve the content owner
+      # detail as the Content Owner, it the channel was authorized with one.
+      # If it was not, the call will fail, since YouTube only allows content
+      # owners to check who is the content owner of a channel.
+      def content_owner_details_params
+        {on_behalf_of_content_owner: auth.owner_name || auth.id}
+      end
     end
   end
 end

data/lib/yt/models/content_owner_detail.rb

@@ -0,0 +1,47 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Encapsulates channel data that is relevant for YouTube Partners linked
+    # with the channel.
+    # @see https://developers.google.com/youtube/v3/docs/channels#contentOwnerDetails
+    class ContentOwnerDetail < Base
+      def initialize(options = {})
+        @data = options[:data] || {}
+      end
+
+      # Returns the name of the content owner linked to the channel.
+      #
+      # This method requires {Resource#auth auth} to return an authenticated
+      # instance of {Yt::ContentOwner} that can administer the channel.
+      # @return [String] if the channel is partnered with a content owner,
+      #   the name of the content owner linked to the channel.
+      # @return [nil] if the channel is not partnered with a content owner.
+      # @return [nil] 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 content_owner
+        @content_owner ||= @data['contentOwner']
+      end
+
+      # Returns the date and time of when the channel was linked to the content
+      # owner.
+      #
+      # This method requires {Resource#auth auth} to return an authenticated
+      # instance of {Yt::ContentOwner} that can administer the channel.
+      # @return [Time] if the channel is partnered with a content owner,
+      #   the date and time when the channel was linked with the content owner.
+      # @return [nil] if the channel is not partnered with a content owner.
+      # @return [nil] 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
+        @linked_at ||= if @data['timeLinked']
+          Time.parse @data['timeLinked']
+        end
+      end
+    end
+  end
+end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.9.7'
+  VERSION = '0.9.8'
 end

data/spec/models/content_owner_detail_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'yt/models/content_owner_detail'
+
+describe Yt::ContentOwnerDetail do
+  subject(:content_owner_detail) { Yt::ContentOwnerDetail.new data: data }
+
+  describe '#content_owner' do
+    context 'given a content_owner_detail with a content owner' do
+      let(:data) { {"contentOwner"=>"FullScreen"} }
+      it { expect(content_owner_detail.content_owner).to eq 'FullScreen' }
+    end
+
+    context 'given a content_owner_detail without a content owner' do
+      let(:data) { {} }
+      it { expect(content_owner_detail.content_owner).to be_nil }
+    end
+  end
+
+  describe '#linked_at' do
+    context 'given a content_owner_detail with a timeLinked' do
+      let(:data) { {"timeLinked"=>"2014-04-22T19:14:49.000Z"} }
+      it { expect(content_owner_detail.linked_at.year).to be 2014 }
+    end
+
+    context 'given a content_owner_detail with a timeLinked' do
+      let(:data) { {} }
+      it { expect(content_owner_detail.linked_at).to be_nil }
+    end
+  end
+end

data/spec/requests/as_account/channel_spec.rb

@@ -105,6 +105,11 @@ describe Yt::Channel, :device_app do
       expect{channel.viewer_percentages}.not_to raise_error
       expect{channel.viewer_percentage}.not_to raise_error
     end
+
+    it 'cannot give information about its content owner' do
+      expect{channel.content_owner}.to raise_error Yt::Errors::Forbidden
+      expect{channel.linked_at}.to raise_error Yt::Errors::Forbidden
+    end
   end
 
   context 'given an unknown channel' do

data/spec/requests/as_content_owner/channel_spec.rb

@@ -263,13 +263,25 @@ describe Yt::Channel, :partner do
         expect(channel.viewer_percentage(gender: :male)).to be_a Float
         expect(channel.viewer_percentage(gender: :female)).to be_a Float
       end
+
+      specify 'information about its content owner can be retrieved' do
+        expect(channel.content_owner).to be_a String
+        expect(channel.linked_at).to be_a Time
+      end
     end
 
     context 'not managed by the authenticated Content Owner' do
       let(:id) { 'UCBR8-60-B28hp2BmDPdntcQ' }
 
-      it { expect{channel.earnings}.to raise_error Yt::Errors::Forbidden }
-      it { expect{channel.views}.to raise_error Yt::Errors::Forbidden }
+      specify 'earnings and impressions cannot be retrieved' do
+        expect{channel.earnings}.to raise_error Yt::Errors::Forbidden
+        expect{channel.views}.to raise_error Yt::Errors::Forbidden
+      end
+
+      specify 'information about its content owner cannot be retrieved' do
+        expect(channel.content_owner).to be_nil
+        expect(channel.linked_at).to be_nil
+      end
     end
   end
 end

data/spec/requests/as_content_owner/content_owner_spec.rb

@@ -58,11 +58,6 @@ describe Yt::ContentOwner, :partner do
         let(:video_id) { ENV['YT_TEST_PARTNER_VIDEO_ID'] }
         it { expect(count).to be > 0 }
       end
-
-      context 'given an unknown video ID' do
-        let(:video_id) { '--not-a-matching-video-id--' }
-        it { expect(count).to be_zero }
-      end
     end
 
     describe '.where(q: query)' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.9.7
+  version: 0.9.8
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-02 00:00:00.000000000 Z
+date: 2014-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -106,9 +106,9 @@ files:
 - ".rspec"
 - ".travis.yml"
 - ".yardopts"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
-- HISTORY.md
 - MIT-LICENSE
 - README.md
 - Rakefile
@@ -134,6 +134,7 @@ files:
 - lib/yt/collections/channels.rb
 - lib/yt/collections/claims.rb
 - lib/yt/collections/content_details.rb
+- lib/yt/collections/content_owner_details.rb
 - lib/yt/collections/content_owners.rb
 - lib/yt/collections/device_flows.rb
 - lib/yt/collections/ids.rb
@@ -170,6 +171,7 @@ files:
 - lib/yt/models/configuration.rb
 - lib/yt/models/content_detail.rb
 - lib/yt/models/content_owner.rb
+- lib/yt/models/content_owner_detail.rb
 - lib/yt/models/description.rb
 - lib/yt/models/device_flow.rb
 - lib/yt/models/id.rb
@@ -209,6 +211,7 @@ files:
 - spec/models/claim_spec.rb
 - spec/models/configuration_spec.rb
 - spec/models/content_detail_spec.rb
+- spec/models/content_owner_detail_spec.rb
 - spec/models/description_spec.rb
 - spec/models/live_streaming_detail_spec.rb
 - spec/models/playlist_item_spec.rb
@@ -291,6 +294,7 @@ test_files:
 - spec/models/claim_spec.rb
 - spec/models/configuration_spec.rb
 - spec/models/content_detail_spec.rb
+- spec/models/content_owner_detail_spec.rb
 - spec/models/description_spec.rb
 - spec/models/live_streaming_detail_spec.rb
 - spec/models/playlist_item_spec.rb