yt 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 846cf65cd693a7468f2785fcfa6d5d3a8e207bc4
-  data.tar.gz: ed6d1a9ec9d57f7367cbd1a6f2308296d3ec9f82
+  metadata.gz: 8853f3441a92a6cb17f3a73193f1b21b7f3a5a3d
+  data.tar.gz: f23617ccbf92ae86d002de6a412a083db7015d93
 SHA512:
-  metadata.gz: d9afc53fa7a90fe4a5fe373356b5dbd95bcc929f4e0abc108f890042d3d3b80d715ce60c54e4df9b8f6d2699be930c8637e62d4be51cb13275266dedbd53b6de
-  data.tar.gz: 5edb54c2610d58f5de2843b7a7d2d905ca3f3bc2028e6e6b03f2bbf529db367513cdab5c72e4d0e5a006d04e359d46618c77b57f46697214cc3d42018c5fd7b6
+  metadata.gz: 39f3ac3e556b1194961d346da9c13ddbc6ce370e44c9063af679c834fa290ca9b6ae110fb63456fa1e973ee7dad7e9cc6d42b6626a230912239e18c440b1d2d0
+  data.tar.gz: e7cd4d3d44ba2fa7faeb0b1d3da548f07098f2c55a6dba2b0d35decf8dcdecbf134d39a039ddf6d259a0228de14f9138ebb212a2a4db74e550d78ab8bf452816

data/.travis.yml

@@ -28,3 +28,4 @@ env:
   - 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=

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    yt (0.9.0)
+    yt (0.9.1)
       activesupport
 
 GEM

data/HISTORY.md

@@ -2,6 +2,8 @@ v0.9 - 2014/07/28
 -----------------
 
 * [breaking change] Rename rating.update to rating.set
+* Add content_owner.references to retrieve ContentID references
+
 
 v0.8 - 2014/07/18
 -----------------

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.0'
+    gem 'yt', '~> 0.9.1'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -105,6 +105,8 @@ content_owner.partnered_channels.first #=> #<Yt::Models::Channel @id=...>
 
 content_owner.claims.where(q: 'Fullscreen').count #=> 24
 content_owner.claims.first #=> #<Yt::Models::Claim @id=...>
+
+content_owner.references.where(asset_id: "ABCDEFG").first => #<Yt::Models::Reference @id=...>
 ```
 
 *All the above methods require authentication (see below).*

data/lib/yt/collections/references.rb

@@ -0,0 +1,36 @@
+require 'yt/collections/base'
+require 'yt/models/reference'
+
+module Yt
+  module Collections
+    # Provides methods to interact with a collection of Content ID references.
+    #
+    # Resources with references are: {Yt::Models::ContentOwner content owners}.
+    class References < Base
+
+    private
+
+      def new_item(data)
+        Yt::Reference.new data: data
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to list references
+      #   administered by the content owner.
+      # @see https://developers.google.com/youtube/partner/docs/v1/references/list
+      def list_params
+        super.tap do |params|
+          params[:params] = references_params
+          params[:path] = '/youtube/partner/v1/references'
+        end
+      end
+
+      def references_params
+        {onBehalfOfContentOwner: @parent.owner_name}.tap do |params|
+          (@extra_params ||= {}).each do |key, value|
+            params[key.to_s.camelize :lower] = value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/yt/models/content_owner.rb

@@ -15,6 +15,10 @@ module Yt
       #   @return [Yt::Collection::Claims] the claims administered by the content owner.
       has_many :claims
 
+      # @!attribute [r] references
+      #   @return [Yt::Collection::References] the references administered by the content owner.
+      has_many :references
+
       def initialize(options = {})
         super options
         @owner_name = options[:owner_name]

data/lib/yt/models/playlist.rb

@@ -23,17 +23,23 @@ module Yt
         !exists?
       end
 
-      def update(options = {})
-        options[:title] ||= title
-        options[:description] ||= description
-        options[:tags] ||= tags
-        options[:privacy_status] ||= privacy_status
+      def update(attributes = {})
+        underscore_keys! attributes
 
-        snippet = options.slice :title, :description, :tags
-        status = {privacyStatus: options[:privacy_status]}
-        body = {id: @id, snippet: snippet, status: status}
+        body = {id: @id}.tap do |body|
+          update_parts.each do |part, options|
+            if (options[:keys] & attributes.keys).any? || options[:required]
+              body[part] = {}.tap do |hash|
+                options[:keys].map do |key|
+                  hash[camelize key] = attributes[key] || send(key)
+                end
+              end
+            end
+          end
+        end
 
-        do_update(params: {part: 'snippet,status'}, body: body) do |data|
+        part = body.except(:id).keys.join(',')
+        do_update(params: {part: part}, body: body) do |data|
           @id = data['id']
           @snippet = Snippet.new data: data['snippet'] if data['snippet']
           @status = Status.new data: data['status'] if data['status']
@@ -75,6 +81,25 @@ module Yt
 
     private
 
+      # @see https://developers.google.com/youtube/v3/docs/playlists/update
+      def update_parts
+        snippet = {keys: [:title, :description, :tags], required: true}
+        status = {keys: [:privacy_status]}
+        {snippet: snippet, status: status}
+      end
+
+      # @note If we dropped support for ActiveSupport 3, then we could simply
+      # invoke transform_keys!{|key| key.to_s.underscore.to_sym}
+      def underscore_keys!(hash)
+        hash.dup.each_key do |key|
+          hash[key.to_s.underscore.to_sym] = hash.delete key
+        end
+      end
+
+      def camelize(value)
+        value.to_s.camelize(:lower).to_sym
+      end
+
       def video_params(video_id)
         {id: video_id, kind: :video}
       end

data/lib/yt/models/reference.rb

@@ -0,0 +1,178 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube ContentID references.
+    # @see https://developers.google.com/youtube/partner/docs/v1/references
+    class Reference < Base
+      def initialize(options = {})
+        @data = options[:data]
+      end
+
+      # @return [String] the ID that YouTube assigns and uses to uniquely
+      #   identify the reference.
+      def id
+        @id ||= @data['id']
+      end
+
+      # @return [String] the ID that uniquely identifies the asset that the
+      #   reference is associated with.
+      def asset_id
+        @asset_id ||= @data["assetId"]
+      end
+
+      # @return [Float] The length of the reference in seconds
+      def length
+        @length ||= @data["length"]
+      end
+
+      # @return [String] the ID of the source video. This field is only present
+      #   if the reference was created by associating an asset with an existing
+      #   YouTube video that was uploaded to a YouTube channel linked to your
+      #   CMS account.
+      def video_id
+        @video_id ||= @data["videoId"]
+      end
+
+      # @return [String] the claim ID that represents the resulting association
+      #   between the asset and the video. This field is only present if the
+      #   reference was created by associating an asset with an existing
+      #   YouTube video that was uploaded to a YouTube channel linked to your
+      #   CMS account.
+      def claim_id
+        @claim_id ||= @data["claimId"]
+      end
+
+      # @return [boolean] whether or not the reference content is included in
+      #   YouTube's AudioSwap program. Set this field's value to true to
+      #   indicate that  the reference content should be included in YouTube's
+      #   AudioSwap program.
+      def audioswap_enabled?
+        @audioswap_enabled ||= @data["audioswapEnabled"]
+      end
+
+      # @return [boolean] should the reference be used to generate claims. Set
+      #   this value to true to indicate that the reference should not be used
+      #   to generate claims. This field is only used on AudioSwap references.
+      def ignore_fp_match?
+        @ignore_fp_match ||= @data["ignoreFpMatch"]
+      end
+
+      # @return [Boolean] the urgent status of the reference file.
+      #   Set this value to true to indicate that YouTube should prioritize
+      #   Content ID processing for a video file. YouTube processes urgent
+      #   video files before other files that are not marked as urgent.
+      #   This setting is primarily used for videos of live events or other
+      #   videos that require time-sensitive processing.
+      #   The sooner YouTube completes Content ID processing for a video, the
+      #   sooner YouTube can match user-uploaded videos to that video.
+      def urgent?
+        @urgent ||= @data["urgent"]
+      end
+
+      # @return [String] An explanation of how a reference entered its current
+      #   state. This value is only present if the reference’s status is either
+      #   inactive or deleted.
+      def status_reason
+        @status_reason ||= @data["statusReason"]
+      end
+
+      # @return [String] The ID that uniquely identifies the reference that
+      #   this reference duplicates. This field is only present if the
+      #   reference’s status is duplicate_on_hold.
+      def duplicate_leader
+        @duplicate_leader ||= @data["duplicateLeader"]
+      end
+
+# Status
+
+      STATUSES = %q(activating active checking computing_fingerprint deleted
+        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.
+      def status
+        @status ||= @data["status"]
+      end
+
+      # @return [Boolean] whether the reference is pending.
+      def activating?
+        status == 'activating'
+      end
+
+      # @return [Boolean] whether the reference is active.
+      def active?
+        status == 'active'
+      end
+
+      # @return [Boolean] whether the reference is being compared to existing
+      #   references to identify any reference conflicts that might exist.
+      def checking?
+        status == 'checking'
+      end
+
+      # @return [Boolean] whether the reference’s fingerprint is being
+      #   computed.
+      def computing_fingerprint?
+        status == 'computing_fingerprint'
+      end
+
+      # @return [Boolean] whether the reference is deleted.
+      def deleted?
+        status == 'deleted'
+      end
+
+      # @return [Boolean] whether the reference iis a duplicate and is on hold.
+      def duplicate_on_hold?
+        status == 'duplicate_on_hold'
+      end
+
+      # @return [Boolean] whether the reference is inactive.
+      def inactive?
+        status == 'inactive'
+      end
+
+      # @return [Boolean] whether the reference is being processed from a live
+      #   video stream.
+      def live_streaming_processing?
+        status == 'live_streaming_processing'
+      end
+
+      # @return [Boolean] whether the reference is urgent_reference_processing.
+      def urgent_reference_processing?
+        status == 'urgent_reference_processing'
+      end
+
+# Content Type
+
+      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.
+      def content_type
+        @content_type ||= @data["contentType"]
+      end
+
+      # @return [Boolean] whether the reference covers the audio of the
+      #   content.
+      def audio?
+        content_type == 'audio'
+      end
+
+      # @return [Boolean] whether the reference covers the video of the
+      #   content.
+      def video?
+        content_type == 'video'
+      end
+
+      # @return [Boolean] whether the reference covers the audiovisual of the
+      #   content.
+      def audiovisual?
+        content_type == 'audiovisual'
+      end
+    end
+  end
+end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.9.0'
+  VERSION = '0.9.1'
 end

data/spec/models/reference_spec.rb

@@ -0,0 +1,249 @@
+require 'spec_helper'
+require 'yt/models/reference'
+
+describe Yt::Reference do
+  subject(:reference) { Yt::Reference.new data: data }
+
+  describe '#id' do
+    context 'given fetching a reference returns an id' do
+      let(:data) { {"id"=>"aBcD1EfGHIk"} }
+      it { expect(reference.id).to eq 'aBcD1EfGHIk' }
+    end
+  end
+
+  describe '#asset_id' do
+    context 'given fetching a reference returns an assetId' do
+      let(:data) { {"assetId"=>"A123456789012601"} }
+      it { expect(reference.asset_id).to eq 'A123456789012601' }
+    end
+  end
+
+  describe '#status' do
+    context 'given fetching a reference returns a status' do
+      let(:data) { {"status"=>"active"} }
+      it { expect(reference.status).to eq 'active' }
+    end
+  end
+
+  describe '#activating?' do
+    context 'given fetching a reference returns an activating status' do
+      let(:data) { {"status"=>"activating"} }
+      it { expect(reference).to be_activating }
+    end
+
+    context 'given fetching a reference does not return an activating status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_activating }
+    end
+  end
+
+  describe '#active?' do
+    context 'given fetching a reference returns an active status' do
+      let(:data) { {"status"=>"active"} }
+      it { expect(reference).to be_active }
+    end
+
+    context 'given fetching a reference does not return an active status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_active }
+    end
+  end
+
+  describe '#checking?' do
+    context 'given fetching a reference returns an checking status' do
+      let(:data) { {"status"=>"checking"} }
+      it { expect(reference).to be_checking }
+    end
+
+    context 'given fetching a reference does not return an checking status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_checking }
+    end
+  end
+
+  describe '#computing_fingerprint?' do
+    context 'given fetching a reference returns an computing_fingerprint status' do
+      let(:data) { {"status"=>"computing_fingerprint"} }
+      it { expect(reference).to be_computing_fingerprint }
+    end
+
+    context 'given fetching a reference does not return an computing_fingerprint status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_computing_fingerprint }
+    end
+  end
+
+  describe '#deleted?' do
+    context 'given fetching a reference returns an deleted status' do
+      let(:data) { {"status"=>"deleted"} }
+      it { expect(reference).to be_deleted }
+    end
+
+    context 'given fetching a reference does not return an deleted status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_deleted }
+    end
+  end
+
+  describe '#duplicate_on_hold?' do
+    context 'given fetching a reference returns an duplicate_on_hold status' do
+      let(:data) { {"status"=>"duplicate_on_hold"} }
+      it { expect(reference).to be_duplicate_on_hold }
+    end
+
+    context 'given fetching a reference does not return an duplicate_on_hold status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_duplicate_on_hold }
+    end
+  end
+
+  describe '#inactive?' do
+    context 'given fetching a reference returns an inactive status' do
+      let(:data) { {"status"=>"inactive"} }
+      it { expect(reference).to be_inactive }
+    end
+
+    context 'given fetching a reference does not return an inactive status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_inactive }
+    end
+  end
+
+  describe '#live_streaming_processing?' do
+    context 'given fetching a reference returns an live_streaming_processing status' do
+      let(:data) { {"status"=>"live_streaming_processing"} }
+      it { expect(reference).to be_live_streaming_processing }
+    end
+
+    context 'given fetching a reference does not return an live_streaming_processing status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_live_streaming_processing }
+    end
+  end
+
+  describe '#urgent_reference_processing?' do
+    context 'given fetching a reference returns an urgent_reference_processing status' do
+      let(:data) { {"status"=>"urgent_reference_processing"} }
+      it { expect(reference).to be_urgent_reference_processing }
+    end
+
+    context 'given fetching a reference does not return an urgent_reference_processing status' do
+      let(:data) { {"status"=>"unknown"} }
+      it { expect(reference).not_to be_urgent_reference_processing }
+    end
+  end
+
+  describe '#status_reason' do
+    context 'given fetching a reference returns a statusReason' do
+      let(:data) { {"statusReason"=>"explanation"} }
+      it { expect(reference.status_reason).to eq 'explanation' }
+    end
+  end
+
+  describe '#duplicate_leader' do
+    context 'given fetching a reference returns a duplicateLeader' do
+      let(:data) { {"duplicateLeader"=>"123456"} }
+      it { expect(reference.duplicate_leader).to eq '123456' }
+    end
+  end
+
+  describe '#length' do
+    context 'given fetching a reference returns a length' do
+      let(:data) { {"length"=>354.66} }
+      it { expect(reference.length).to eq 354.66 }
+    end
+  end
+
+  describe '#video_id' do
+    context 'given fetching a reference returns an videoId' do
+      let(:data) { {"videoId"=>"MESycYJytkU"} }
+      it { expect(reference.video_id).to eq 'MESycYJytkU' }
+    end
+  end
+
+  describe '#claim_id' do
+    context 'given fetching a reference returns an claimId' do
+      let(:data) { {"claimId"=>"aBcD1EfGHIk"} }
+      it { expect(reference.claim_id).to eq 'aBcD1EfGHIk' }
+    end
+  end
+
+  describe '#urgent?' do
+    context 'given fetching a reference returns an urgent status true' do
+      let(:data) { {"urgent"=>true} }
+      it { expect(reference).to be_urgent }
+    end
+
+    context 'given fetching a reference returns an urgent status false' do
+      let(:data) { {"urgent"=>false} }
+      it { expect(reference).not_to be_urgent }
+    end
+  end
+
+  describe '#content_type' do
+    context 'given fetching a reference returns a content type' do
+      let(:data) { {"contentType"=>"audio"} }
+      it { expect(reference.content_type).to eq 'audio' }
+    end
+  end
+
+  describe '#audio?' do
+    context 'given fetching a reference returns an audio content type' do
+      let(:data) { {"contentType"=>"audio"} }
+      it { expect(reference).to be_audio }
+    end
+
+    context 'given fetching a reference does not return an audio content type' do
+      let(:data) { {"contentType"=>"audiovisual"} }
+      it { expect(reference).not_to be_audio }
+    end
+  end
+
+  describe '#video?' do
+    context 'given fetching a reference returns an video content type' do
+      let(:data) { {"contentType"=>"video"} }
+      it { expect(reference).to be_video }
+    end
+
+    context 'given fetching a reference does not return an video content type' do
+      let(:data) { {"contentType"=>"audiovisual"} }
+      it { expect(reference).not_to be_video }
+    end
+  end
+
+  describe '#audiovisual?' do
+    context 'given fetching a reference returns an audiovisual content type' do
+      let(:data) { {"contentType"=>"audiovisual"} }
+      it { expect(reference).to be_audiovisual }
+    end
+
+    context 'given fetching a reference does not return an audiovisual content type' do
+      let(:data) { {"contentType"=>"audio"} }
+      it { expect(reference).not_to be_audiovisual }
+    end
+  end
+
+  describe '#audioswap_enabled?' do
+    context 'given fetching a reference returns audioswapEnabled true' do
+      let(:data) { {"audioswapEnabled"=>true} }
+      it { expect(reference).to be_audioswap_enabled }
+    end
+
+    context 'given fetching a reference returns audioswapEnabled false' do
+      let(:data) { {"audioswap_enabled"=>false} }
+      it { expect(reference).not_to be_audioswap_enabled }
+    end
+  end
+
+  describe '#ignore_fp_match?' do
+    context 'given fetching a reference returns ignoreFpMatch true' do
+      let(:data) { {"ignoreFpMatch"=>true} }
+      it { expect(reference.ignore_fp_match?).to be true }
+    end
+
+    context 'given fetching a reference returns ignoreFpMatch false' do
+      let(:data) { {"ignoreFpMatch"=>false} }
+      it { expect(reference.ignore_fp_match?).to be false }
+    end
+  end
+end

data/spec/requests/as_account/playlist_spec.rb

@@ -51,20 +51,68 @@ describe Yt::Playlist, :device_app do
     before(:all) { @my_playlist = $account.create_playlist title: "Yt Test Update Playlist #{rand}" }
     after(:all) { @my_playlist.delete }
     let(:id) { @my_playlist.id }
+    let!(:old_title) { @my_playlist.title }
+    let!(:old_privacy_status) { @my_playlist.privacy_status }
+    let(:update) { @my_playlist.update attrs }
+
+    context 'given I update the title' do
+      # NOTE: The use of UTF-8 characters is to test that we can pass up to
+      # 50 characters, independently of their representation
+      let(:attrs) { {title: "Yt Example Update Playlist #{rand} - ®•♡❥❦❧☙"} }
+
+      specify 'only updates the title' do
+        expect(update).to be true
+        expect(@my_playlist.title).not_to eq old_title
+        expect(@my_playlist.privacy_status).to eq old_privacy_status
+      end
+    end
+
+    context 'given I update the description' do
+      let!(:old_description) { @my_playlist.description }
+      let(:attrs) { {description: "Yt Example Description  #{rand} - ®•♡❥❦❧☙"} }
+
+      specify 'only updates the description' do
+        expect(update).to be true
+        expect(@my_playlist.description).not_to eq old_description
+        expect(@my_playlist.title).to eq old_title
+        expect(@my_playlist.privacy_status).to eq old_privacy_status
+      end
+    end
+
+    context 'given I update the tags' do
+      let!(:old_tags) { @my_playlist.tags }
+      let(:attrs) { {tags: ["Yt Test Tag #{rand}"]} }
 
-    describe 'updates the attributes that I specify explicitly' do
-      let(:attrs) { {title: "Yt Test Update Playlist #{rand} - new title"} }
-      it { expect(playlist.update attrs).to eq true }
-      it { expect{playlist.update attrs}.to change{playlist.title} }
+      specify 'only updates the tag' do
+        expect(update).to be true
+        expect(@my_playlist.tags).not_to eq old_tags
+        expect(@my_playlist.title).to eq old_title
+        expect(@my_playlist.privacy_status).to eq old_privacy_status
+      end
     end
 
-    describe 'does not update the other attributes' do
-      let(:attrs) { {} }
-      it { expect(playlist.update attrs).to eq true }
-      it { expect{playlist.update attrs}.not_to change{playlist.title} }
-      it { expect{playlist.update attrs}.not_to change{playlist.description} }
-      it { expect{playlist.update attrs}.not_to change{playlist.tags} }
-      it { expect{playlist.update attrs}.not_to change{playlist.privacy_status} }
+    context 'given I update the privacy status' do
+      let!(:new_privacy_status) { old_privacy_status == 'private' ? 'unlisted' : 'private' }
+
+      context 'passing the parameter in underscore syntax' do
+        let(:attrs) { {privacy_status: new_privacy_status} }
+
+        specify 'only updates the privacy status' do
+          expect(update).to be true
+          expect(@my_playlist.privacy_status).not_to eq old_privacy_status
+          expect(@my_playlist.title).to eq old_title
+        end
+      end
+
+      context 'passing the parameter in camel-case syntax' do
+        let(:attrs) { {privacyStatus: new_privacy_status} }
+
+        specify 'only updates the privacy status' do
+          expect(update).to be true
+          expect(@my_playlist.privacy_status).not_to eq old_privacy_status
+          expect(@my_playlist.title).to eq old_title
+        end
+      end
     end
 
     context 'given an existing video' do

data/spec/requests/as_content_owner/content_owner_spec.rb

@@ -85,4 +85,32 @@ describe Yt::ContentOwner, :partner do
       end
     end
   end
+
+  describe '.references' do
+    describe '.where(id: reference_id)' do
+      let(:reference) { $content_owner.references.where(id: reference_id).first }
+
+      context 'given the ID of a reference administered by the content owner' do
+        let(:reference_id) { ENV['YT_TEST_PARTNER_REFERENCE_ID'] }
+
+        it 'returns valid metadata' do
+          expect(reference.id).to be_a String
+          expect(reference.asset_id).to be_a String
+          expect(reference.length).to be_a Float
+          expect(reference.video_id).to be_a String
+          expect(reference.claim_id).to be_a String
+          expect(reference.audioswap_enabled?).to be_in [true, false]
+          expect(reference.ignore_fp_match?).to be_in [true, false]
+          expect(reference.urgent?).to be_in [true, false]
+          expect(reference.status).to be_in Yt::Reference::STATUSES
+          expect(reference.content_type).to be_in Yt::Reference::CONTENT_TYPES
+        end
+      end
+
+      context 'given an unknown reference ID' do
+        let(:reference_id) { '--not-a-matching-reference-id--' }
+        it { expect(reference).not_to be }
+      end
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-28 00:00:00.000000000 Z
+date: 2014-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -141,6 +141,7 @@ files:
 - lib/yt/collections/playlist_items.rb
 - lib/yt/collections/playlists.rb
 - lib/yt/collections/ratings.rb
+- lib/yt/collections/references.rb
 - lib/yt/collections/reports.rb
 - lib/yt/collections/resources.rb
 - lib/yt/collections/resumable_sessions.rb
@@ -173,6 +174,7 @@ files:
 - lib/yt/models/playlist.rb
 - lib/yt/models/playlist_item.rb
 - lib/yt/models/rating.rb
+- lib/yt/models/reference.rb
 - lib/yt/models/request.rb
 - lib/yt/models/resource.rb
 - lib/yt/models/resumable_session.rb
@@ -208,6 +210,7 @@ files:
 - spec/models/playlist_item_spec.rb
 - spec/models/playlist_spec.rb
 - spec/models/rating_spec.rb
+- spec/models/reference_spec.rb
 - spec/models/request_spec.rb
 - spec/models/resource_spec.rb
 - spec/models/snippet_spec.rb
@@ -289,6 +292,7 @@ test_files:
 - spec/models/playlist_item_spec.rb
 - spec/models/playlist_spec.rb
 - spec/models/rating_spec.rb
+- spec/models/reference_spec.rb
 - spec/models/request_spec.rb
 - spec/models/resource_spec.rb
 - spec/models/snippet_spec.rb