yt 0.13.7 → 0.13.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 92bd4d67d0b039373542dd45a4f85abaf95d3aa3
-  data.tar.gz: 8ec36efd6d006f719ff41fa9a85cda983ee9ac5f
+  metadata.gz: c180d75d3544370dcf5ad0bf29cd7da6a22b62b3
+  data.tar.gz: f2d6f98305c7f759e63f9350d8b9d15b28326b1c
 SHA512:
-  metadata.gz: 575970ef892b48beb15b0ff0266ebc67f68e175820696b30fdfbbde1017039a4fb1eafb83c86aa46819e6bf399ae9f3ea868c6c1a75125e8cc546d1fab61195b
-  data.tar.gz: b25da01c60ec08ae5a7aa8796a5f778e3038a0f32532a8cbb9b201f39fad91be71bf69a3cca0f11daa09b0f8386d9c4468580b7bc846bab7aca07009b72892d4
+  metadata.gz: 733901314de6696b5c92d2e6040d50823fc83e78b7bea221df6c3c9616e4fa640da693dcb1900afb260d3a903a6e46e2763ea4f6d597b8b69faf928ad38b5d87
+  data.tar.gz: 3b30960bbed06617f1632f41b148946bdc37fad836b5b6a48913a0de7587209e46ba17e1640898facc5f082902b0685a43ccb227e89bb8bcdbdffd33c6f52ff8

data/CHANGELOG.md

@@ -6,6 +6,12 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.13.8 - 2015-01-15
+
+* [FEATURE] AssetSearch resources available.
+* [FEATURE] Access asset metadata (`effective` and `mine`) via the asset object.
+* [ENHANCEMENT] Support `isManualClaim` parameter in claims#insert.
+
 ## 0.13.7 - 2014-10-27
 
 * [FEATURE] New video reports: monetized playbacks.

data/Gemfile

@@ -1,4 +1,4 @@
 source 'https://rubygems.org'
-gem 'pry'
+
 # Specify your gem's dependencies in yt.gemspec
 gemspec

data/lib/yt/actions/list.rb

@@ -74,7 +74,6 @@ module Yt
         {data: data, auth: @auth}
       end
 
-
       def more_pages?
         @last_index.zero? || !@page_token.nil?
       end

data/lib/yt/collections/assets.rb

@@ -1,5 +1,6 @@
 require 'yt/collections/base'
 require 'yt/models/asset'
+require 'yt/models/asset_snippet'
 
 module Yt
   module Collections
@@ -16,6 +17,37 @@ module Yt
 
     private
 
+      def new_item(data)
+        klass = (data["kind"] == "youtubePartner#assetSnippet") ? Yt::AssetSnippet : Yt::Asset
+        klass.new attributes_for_new_item(data)
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to list assets
+      #   owned by the content owner.
+      # @see https://developers.google.com/youtube/partner/docs/v1/assets/list
+      def list_params
+        super.tap do |params|
+          params[:path] = assets_path
+          params[:params] = assets_params
+        end
+      end
+
+      def assets_params
+        apply_where_params! on_behalf_of_content_owner: @auth.owner_name
+      end
+
+      # @private
+      # @todo: This is one of three places outside of base.rb where @where_params
+      #   is accessed; it should be replaced with a filter on params instead.
+      def assets_path
+        @where_params ||= {}
+        if @where_params.empty? || @where_params.key?(:id)
+          '/youtube/partner/v1/assets'
+        else
+          '/youtube/partner/v1/assetSearch'
+        end
+      end
+
       # @return [Hash] the parameters to submit to YouTube to add a asset.
       # @see https://developers.google.com/youtube/partner/docs/v1/assets/insert
       def insert_params

data/lib/yt/collections/claims.rb

@@ -11,7 +11,7 @@ module Yt
         underscore_keys! attributes
         body = attributes.slice :asset_id, :video_id, :content_type, :policy
         body[:policy] = {id: attributes[:policy_id]} if attributes[:policy_id]
-        params = {on_behalf_of_content_owner: @auth.owner_name}
+        params = attributes.slice(:is_manual_claim).merge({on_behalf_of_content_owner: @auth.owner_name})
         do_insert(params: params, body: body)
       end
 
@@ -41,7 +41,7 @@ module Yt
       end
 
       # @private
-      # @todo: This is one of two places outside of base.rb where @where_params
+      # @todo: This is one of three places outside of base.rb where @where_params
       #   is accessed; it should be replaced with a filter on params instead.
       def claims_path
         @where_params ||= {}

data/lib/yt/collections/videos.rb

@@ -71,7 +71,7 @@ module Yt
       # /videos should be used when the query specifies video IDs or a chart,
       # /search otherwise.
       # @return [Boolean] whether to use the /videos endpoint.
-      # @todo: This is one of two places outside of base.rb where @where_params
+      # @todo: This is one of three places outside of base.rb where @where_params
       #   is accessed; it should be replaced with a filter on params instead.
       def use_list_endpoint?
         @where_params ||= {}

data/lib/yt/models/asset.rb

@@ -1,4 +1,5 @@
 require 'yt/models/base'
+require 'yt/models/asset_metadata'
 
 module Yt
   module Models
@@ -8,7 +9,7 @@ module Yt
       attr_reader :auth
 
       def initialize(options = {})
-        @data = options[:data]
+        @data = options.fetch(:data, {})
         @id = options[:id]
         @auth = options[:auth]
       end
@@ -25,6 +26,14 @@ module Yt
       delegate :general_owners, :performance_owners, :synchronization_owners,
         :mechanical_owners, to: :ownership
 
+      def metadata_mine
+        @metadata_mine ||= Yt::Models::AssetMetadata.new data: @data.fetch('metadataMine', {})
+      end
+
+      def metadata_effective
+        @metadata_effective ||= Yt::Models::AssetMetadata.new data: @data.fetch('metadataEffective', {})
+      end
+
       # Soft-deletes the asset.
       # @note YouTube API does not provide a +delete+ method for the Asset
       #   resource, but only an +update+ method. Updating the +status+ of a
@@ -54,6 +63,12 @@ module Yt
       #   video_game, and web.
       has_attribute :type
 
+      # @return [Array<Yt::Models::Tag>] the list of asset labels associated
+      #   with the asset. You can apply a label to multiple assets to group
+      #   them. You can use the labels as search filters to perform bulk updates,
+      #   to download reports, or to filter YouTube Analytics.
+      has_attribute :label
+
 # Status
 
       STATUSES = %q(active inactive pending)

data/lib/yt/models/asset_metadata.rb

@@ -0,0 +1,38 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # The AssetMetadata object specifies the metadata for an asset.
+    # @see https://developers.google.com/youtube/partner/docs/v1/assets#metadataMine
+    class AssetMetadata < Base
+      def initialize(options = {})
+        @data = options[:data]
+      end
+
+      # @return [String] A unique value that you, the metadata provider,
+      #   use to identify an asset. The value could be a unique ID that
+      #   you created for the asset or a standard identifier, such as an
+      #   ISRC.
+      def custom_id
+        @data['customId']
+      end
+
+      # @return [String] The asset's title or name.
+      def title
+        @data['title']
+      end
+
+      # @return [String] A description of the asset. The description may be
+      #   displayed on YouTube or in CMS. 
+      def notes
+        @data['notes']
+      end
+
+      # @return [String] the ID that YouTube assigns and uses to uniquely
+      #   identify the asset.
+      def description
+        @data['description']
+      end
+    end
+  end
+end

data/lib/yt/models/asset_snippet.rb

@@ -0,0 +1,45 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube ContentID assetSnippets.
+    # @see https://developers.google.com/youtube/partner/docs/v1/assetSearch
+    class AssetSnippet < Base
+      attr_reader :auth
+
+      def initialize(options = {})
+        @data = options.fetch(:data, {})
+        @auth = options[:auth]
+      end
+
+      # @return [String] the ID that YouTube assigns and uses to uniquely
+      #   identify the asset.
+      has_attribute :id
+
+      # @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.
+      has_attribute :type
+
+      # @return [String] the title of this asset.
+      has_attribute :title
+
+      # @return [String] the Custom ID assigned by the content owner to
+      #   this asset.
+      has_attribute :custom_id
+
+      # @return [String] the ISRC (International Standard Recording Code)
+      #   for this asset.
+      has_attribute :isrc
+
+      # @return [String] the ISWC (International Standard Musical Work Code)
+      #   for this asset.
+      has_attribute :iswc
+    end
+  end
+end

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.13.7'
+  VERSION = '0.13.8'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.13.7
+  version: 0.13.8
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-27 00:00:00.000000000 Z
+date: 2015-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -173,6 +173,8 @@ files:
 - lib/yt/models/advertising_options_set.rb
 - lib/yt/models/annotation.rb
 - lib/yt/models/asset.rb
+- lib/yt/models/asset_metadata.rb
+- lib/yt/models/asset_snippet.rb
 - lib/yt/models/authentication.rb
 - lib/yt/models/base.rb
 - lib/yt/models/channel.rb