yt 0.9.1 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8853f3441a92a6cb17f3a73193f1b21b7f3a5a3d
-  data.tar.gz: f23617ccbf92ae86d002de6a412a083db7015d93
+  metadata.gz: 5fe9ccf19b87eba1932a8381ec62e4c7e18bb997
+  data.tar.gz: bcc2aefb8c393bac857f94157267d66ab96301ae
 SHA512:
-  metadata.gz: 39f3ac3e556b1194961d346da9c13ddbc6ce370e44c9063af679c834fa290ca9b6ae110fb63456fa1e973ee7dad7e9cc6d42b6626a230912239e18c440b1d2d0
-  data.tar.gz: e7cd4d3d44ba2fa7faeb0b1d3da548f07098f2c55a6dba2b0d35decf8dcdecbf134d39a039ddf6d259a0228de14f9138ebb212a2a4db74e550d78ab8bf452816
+  metadata.gz: f3f0ddfe5fcf4c20b72a77478efba519a33db0bf9565b52a47daaa6f768fe68015d3436d4535fdd759443462903c5ec788750ef5595317672c7492d903c25db2
+  data.tar.gz: 0dcc83e353408a679b723516e3801eafd2b1710ee25584040a9d9c359fa8dadac24b44949779b6b4f042a09e3ebd633b737b3c64815bf826ed571bdb0f0169e2

data/Gemfile.lock

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

data/HISTORY.md

@@ -3,6 +3,7 @@ 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
 
 
 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.1'
+    gem 'yt', '~> 0.9.2'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -107,6 +107,7 @@ 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=...>
+content_owner.policies.first => #<Yt::Models::Policy @id=...>
 ```
 
 *All the above methods require authentication (see below).*

data/lib/yt/collections/policies.rb

@@ -0,0 +1,37 @@
+require 'yt/collections/base'
+require 'yt/models/policy'
+
+module Yt
+  module Collections
+    # Provides methods to interact with a collection of Content ID policies.
+    #
+    # Resources with policies are: {Yt::Models::ContentOwner content owners}.
+    class Policies < Base
+
+    private
+
+      def new_item(data)
+        Yt::Policy.new data: data
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to list policies
+      #   saved by the content owner.
+      # @see https://developers.google.com/youtube/partner/docs/v1/policies/list
+      def list_params
+
+        super.tap do |params|
+          params[:params] = policies_params
+          params[:path] = '/youtube/partner/v1/policies'
+        end
+      end
+
+      def policies_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

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

data/lib/yt/models/policy.rb

@@ -0,0 +1,44 @@
+require 'yt/models/base'
+require 'yt/models/policy_rule'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube ContentID policies.
+    # A policy resource specifies rules that define a particular usage or
+    # match policy that a partner can associate with an asset or claim.
+    # @see https://developers.google.com/youtube/partner/docs/v1/policies
+    class Policy < Base
+      def initialize(options = {})
+        @data = options[:data]
+      end
+
+      # @return [String] the ID that YouTube assigns and uses to uniquely
+      #   identify the policy.
+      def id
+        @id ||= @data['id']
+      end
+
+      # @return [String] the policy’s name.
+      def name
+        @name ||= @data['name']
+      end
+
+      # @return [String] the policy’s description.
+      def description
+        @name ||= @data['description']
+      end
+
+      # @return [String] the time the policy was updated.
+      def time_updated
+        @time_updated ||= Time.parse @data['timeUpdated']
+      end
+
+      # @return [Array<PolicyRule>] a list of rules that specify the action
+      #   that YouTube should take and may optionally specify the conditions
+      #   under which that action is enforced.
+      def rules
+        @rules ||= @data['rules'].map{|rule| PolicyRule.new data: rule}
+      end
+    end
+  end
+end

data/lib/yt/models/policy_rule.rb

@@ -0,0 +1,133 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube ContentID policy rules.
+    # Rules that specify the action that YouTube should take and may optionally
+    # specify the conditions under which that action is enforced.
+    # @see https://developers.google.com/youtube/partner/docs/v1/policies
+    class PolicyRule
+      def initialize(options = {})
+        @data = options[:data]
+      end
+
+      ACTIONS = %q(block monetize takedown track)
+
+      # 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.
+      # @return [String] the policy that YouTube should enforce.
+      def action
+        @action ||= @data['action']
+      end
+
+      # @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.
+      def subaction
+        @subaction ||= @data['subaction']
+      end
+
+      # Return the list of territories where the policy applies.
+      # Each territory is an ISO 3166 two-letter country code.
+      # YouTube determines whether the condition is satisfied based on the
+      # user’s location.
+      # @return [Array<String>] the territories where the policy applies.
+      # @example (with 'block' action) only block a video for U.S. users:
+      #   included_territories #=> ['us']
+      def included_territories
+        territories_type == 'include' ? territories : []
+      end
+
+      # Return the list of territories where the policy does not apply.
+      # Each territory is an ISO 3166 two-letter country code.
+      # YouTube determines whether the condition is satisfied based on the
+      # user’s location.
+      # @return [Array<String>] the territories where the policy does not apply.
+      # @example (with 'block' action) only allow U.S. users to view a video:
+      #   excluded_territories #=> ['us']
+      def excluded_territories
+        territories_type == 'exclude' ? territories : []
+      end
+
+      # @return [Array<Hash<Symbol, Float>>] the intervals of time the user-
+      #   or partner-uploaded content needs to match a reference file for the
+      #   rule to apply. :low is the minimum (inclusive) allowed value and
+      #   :high is the maximum (inclusive) allowed value for the rule to apply.
+      # @example videos that match the reference for 20 to 30 seconds:
+      #   match_duration #= [{low: 20.0, high: 30.0}]
+      def match_duration
+        @match_duration ||= match_duration_list.map{|r| low_and_high r}
+      end
+
+      # @return [Array<Hash<Symbol, Float>>] the intervals of percentages the
+      #   user- or partner-uploaded content needs to match a reference file for
+      #   the rule to apply. :low is the minimum (inclusive) allowed value and
+      #   :high is the maximum (inclusive) allowed value for the rule to apply.
+      # @example videos that match the reference for 40%~50% of their duration:
+      #   match_percent #= [{low: 40.0, high: 50.0}]
+      def match_percent
+        @match_percent ||= match_percent_list.map{|r| low_and_high r}
+      end
+
+      # @return [Array<Hash<Symbol, Float>>] the intervals of duration that the
+      #   reference must have for the rule to apply. :low is the minimum
+      #   (inclusive) allowed value, :high is the maximum (inclusive) allowed
+      #   value for the rule to apply.
+      # @example references that are between 20 and 30 seconds:
+      #   reference_duration #= [{low: 20.0, high: 30.0}]
+      def reference_duration
+        @reference_duration ||= reference_duration_list.map{|r| low_and_high r}
+      end
+
+      # @return [Array<Hash<Symbol, Float>>] the intervals of percentages the
+      #   reference file needs to match the user- or partner-uploaded content
+      #   for the rule to apply. :low is the minimum (inclusive) allowed value,
+      #   :high is the maximum (inclusive) allowed value for the rule to apply.
+      # @example videos that match either 0%~10% or 40%~50% of a reference:
+      #   reference_percent #= [{low: 0.0, high: 10.0}, {low: 40.0, high: 50.0}]
+      def reference_percent
+        @reference_percent ||= reference_percent_list.map{|r| low_and_high r}
+      end
+
+    private
+
+      def conditions
+        @conditions ||= @data.fetch 'conditions', {}
+      end
+
+      def territories_object
+        @territories_object ||= conditions.fetch 'requiredTerritories', {}
+      end
+
+      def territories_type
+        @territories_type ||= territories_object['type']
+      end
+
+      def territories
+        @territories ||= territories_object['territories']
+      end
+
+      def match_duration_list
+        @match_duration_list ||= conditions.fetch 'matchDuration', []
+      end
+
+      def match_percent_list
+        @match_percent_list ||= conditions.fetch 'matchPercent', []
+      end
+
+      def reference_duration_list
+        @reference_duration_list ||= conditions.fetch 'referenceDuration', []
+      end
+
+      def reference_percent_list
+        @reference_percent_list ||= conditions.fetch 'referencePercent', []
+      end
+
+      def low_and_high(range)
+        {low: range['low'], high: range['high']}
+      end
+    end
+  end
+end

data/lib/yt/version.rb

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

data/spec/models/policy_rule_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+require 'yt/models/policy_rule'
+
+describe Yt::PolicyRule do
+  subject(:policy_rule) { Yt::PolicyRule.new data: data }
+
+  describe '#action' do
+    context 'given fetching a policy rule returns an action' do
+      let(:data) { {"action"=>"takedown"} }
+      it { expect(policy_rule.action).to eq 'takedown' }
+    end
+  end
+
+  describe '#subaction' do
+    context 'given fetching a policy rule returns a subaction' do
+      let(:data) { {"subaction"=>"review"} }
+      it { expect(policy_rule.subaction).to eq 'review' }
+    end
+  end
+
+  describe '#included_territories' do
+    context 'given fetching a policy rule returns included territories' do
+      let(:data) { {"conditions"=>{"requiredTerritories"=>{"type"=>"include", "territories"=>["US", "CA"]}}} }
+      let(:data) { {"conditions"=>{"requiredTerritories"=>{"type"=>"include", "territories"=>["US", "CA"]}}} }
+      it { expect(policy_rule.included_territories).to eq %w(US CA) }
+    end
+  end
+
+  describe '#excluded_territories' do
+    context 'given fetching a policy rule returns excluded territories' do
+      let(:data) { {"conditions"=>{"requiredTerritories"=>{"type"=>"exclude", "territories"=>["US", "CA"]}}} }
+      it { expect(policy_rule.excluded_territories).to eq %w(US CA) }
+    end
+  end
+
+  describe '#match_duration' do
+    context 'given fetching a policy rule returns a match duration list' do
+      let(:data) { {"conditions"=>{"matchDuration"=>[{"high"=>60.0}]}} }
+      it { expect(policy_rule.match_duration).to match_array [{low: nil, high: 60.0}] }
+    end
+  end
+
+  describe '#match_percent' do
+    context 'given fetching a policy rule returns a match percent list' do
+      let(:data) { {"conditions"=>{"matchPercent"=>[{"high"=>60.0}]}} }
+      it { expect(policy_rule.match_percent).to match_array [{low: nil, high: 60.0}] }
+    end
+  end
+
+  describe '#reference_duration' do
+    context 'given fetching a policy rule returns a reference duration list' do
+      let(:data) { {"conditions"=>{"referenceDuration"=>[{"low"=>60.0, "high"=>600.0}, {"low"=>20.0, "high"=>30.0}]}} }
+      it { expect(policy_rule.reference_duration).to match_array [{low: 60.0, high: 600.0}, {low: 20.0, high: 30.0}] }
+    end
+  end
+
+  describe '#reference_percent' do
+    context 'given fetching a policy rule returns a reference percent list' do
+      let(:data) { {"conditions"=>{"referencePercent"=>[{"low"=>60.0, "high"=>600.0}, {"low"=>20.0, "high"=>30.0}]}} }
+      it { expect(policy_rule.reference_percent).to match_array [{low: 60.0, high: 600.0}, {low: 20.0, high: 30.0}] }
+    end
+  end
+end

data/spec/models/policy_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+require 'yt/models/policy'
+
+describe Yt::Policy do
+  subject(:policy) { Yt::Policy.new data: data }
+
+  describe '#id' do
+    context 'given fetching a policy returns an id' do
+      let(:data) { {"id"=>"S123456789"} }
+      it { expect(policy.id).to eq 'S123456789' }
+    end
+  end
+
+  describe '#name' do
+    context 'given fetching a policy returns a name' do
+      let(:data) { {"name"=>"Block in all countries"} }
+      it { expect(policy.name).to eq 'Block in all countries' }
+    end
+  end
+
+  describe '#description' do
+    context 'given fetching a policy returns a description' do
+      let(:data) { {"description"=>"Block videos in every country"} }
+      it { expect(policy.description).to eq 'Block videos in every country' }
+    end
+  end
+
+  describe '#time_updated' do
+    context 'given fetching a policy returns a timeUpdated' do
+      let(:data) { {"timeUpdated"=>"1970-01-16T20:33:03.675Z"} }
+      it { expect(policy.time_updated.year).to be 1970 }
+    end
+  end
+
+  describe '#rules' do
+    context 'given fetching a policy returns rules' do
+      let(:data) { {"rules"=>[{"action"=>"track"},{"action"=>"track"}]} }
+      it { expect(policy.rules.size).to be 2 }
+    end
+  end
+end

data/spec/requests/as_content_owner/content_owner_spec.rb

@@ -113,4 +113,30 @@ describe Yt::ContentOwner, :partner do
       end
     end
   end
+
+  describe '.policies' do
+    describe 'given the content owner has policies' do
+      let(:policy) { $content_owner.policies.first }
+      let(:rule) { policy.rules.first }
+
+      it 'returns valid metadata' do
+        expect(policy.id).to be_a String
+        expect(policy.name).to be_a String
+        expect(policy.time_updated).to be_a Time
+        expect(rule.action).to  be_in Yt::PolicyRule::ACTIONS
+        expect(rule.included_territories).to be_an Array
+        expect(rule.excluded_territories).to be_an Array
+        expect(rule.match_duration).to be_an Array
+        expect(rule.match_percent).to be_an Array
+        expect(rule.reference_duration).to be_an Array
+        expect(rule.reference_percent).to be_an Array
+      end
+    end
+
+    describe '.where(id: policy_id) given an unknown policy ID' do
+      let(:policy) { $content_owner.policies.where(id: policy_id).first }
+      let(:policy_id) { '--not-a-matching-reference-id--' }
+      it { expect(policy).not_to be }
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
 platform: ruby
 authors:
 - Claudio Baccigalupo
@@ -140,6 +140,7 @@ files:
 - lib/yt/collections/partnered_channels.rb
 - lib/yt/collections/playlist_items.rb
 - lib/yt/collections/playlists.rb
+- lib/yt/collections/policies.rb
 - lib/yt/collections/ratings.rb
 - lib/yt/collections/references.rb
 - lib/yt/collections/reports.rb
@@ -173,6 +174,8 @@ files:
 - lib/yt/models/id.rb
 - lib/yt/models/playlist.rb
 - lib/yt/models/playlist_item.rb
+- lib/yt/models/policy.rb
+- lib/yt/models/policy_rule.rb
 - lib/yt/models/rating.rb
 - lib/yt/models/reference.rb
 - lib/yt/models/request.rb
@@ -209,6 +212,8 @@ files:
 - spec/models/description_spec.rb
 - spec/models/playlist_item_spec.rb
 - spec/models/playlist_spec.rb
+- spec/models/policy_rule_spec.rb
+- spec/models/policy_spec.rb
 - spec/models/rating_spec.rb
 - spec/models/reference_spec.rb
 - spec/models/request_spec.rb
@@ -291,6 +296,8 @@ test_files:
 - spec/models/description_spec.rb
 - spec/models/playlist_item_spec.rb
 - spec/models/playlist_spec.rb
+- spec/models/policy_rule_spec.rb
+- spec/models/policy_spec.rb
 - spec/models/rating_spec.rb
 - spec/models/reference_spec.rb
 - spec/models/request_spec.rb