yt-andrewroth 0.25.5.1

data/lib/yt/collections/content_owners.rb

@@ -0,0 +1,32 @@
+require 'yt/collections/base'
+require 'yt/models/content_owner'
+
+module Yt
+  module Collections
+    # Provides methods to interact with a collection of Content Owners.
+    #
+    # Resources with content_owners are: {Yt::Models::Account accounts}.
+    class ContentOwners < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {owner_name: data['id'], authentication: @auth.authentication}
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to list content
+      #   owners administered by the account.
+      # @see https://developers.google.com/youtube/partner/docs/v1/contentOwners/list
+      def list_params
+        super.tap do |params|
+          params[:params] = content_owners_params
+          params[:path] = '/youtube/partner/v1/contentOwners'
+        end
+      end
+
+      def content_owners_params
+        {fetch_mine: true}
+      end
+    end
+  end
+end

data/lib/yt/collections/device_flows.rb

@@ -0,0 +1,23 @@
+require 'yt/collections/authentications'
+require 'yt/models/device_flow'
+
+module Yt
+  module Collections
+    class DeviceFlows < Authentications
+      attr_accessor :auth_params
+
+    private
+
+      # This overrides the parent mehthod defined in Authentications
+      def attributes_for_new_item(data)
+        {data: data}
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:path] = '/o/oauth2/device/code'
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/file_details.rb

@@ -0,0 +1,30 @@
+require 'yt/collections/base'
+require 'yt/models/file_detail'
+
+module Yt
+  module Collections
+    # @private
+    class FileDetails < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {data: data['fileDetails']}
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to get the
+      #   file detail of a video.
+      # @see https://developers.google.com/youtube/v3/docs/videos#fileDetails
+      def list_params
+        super.tap do |params|
+          params[:params] = file_details_params
+          params[:path] = '/youtube/v3/videos'
+        end
+      end
+
+      def file_details_params
+        {max_results: 50, part: 'fileDetails', id: @parent.id}
+      end
+    end
+  end
+end

data/lib/yt/collections/ids.rb

@@ -0,0 +1,27 @@
+require 'yt/collections/base'
+require 'yt/models/id'
+
+module Yt
+  module Collections
+    # @private
+    class Ids < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        data['id']
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:params] = ids_params
+          params[:path] = "/youtube/v3/#{@parent.kind.pluralize}"
+        end
+      end
+
+      def ids_params
+        {for_username: @parent.username, part: 'id'}
+      end
+    end
+  end
+end

data/lib/yt/collections/live_streaming_details.rb

@@ -0,0 +1,30 @@
+require 'yt/collections/base'
+require 'yt/models/live_streaming_detail'
+
+module Yt
+  module Collections
+    # @private
+    class LiveStreamingDetails < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {data: data['liveStreamingDetails']}
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to get the
+      #   live streaming detail of a resource, for instance a video.
+      # @see https://developers.google.com/youtube/v3/docs/videos#resource
+      def list_params
+        super.tap do |params|
+          params[:params] = live_streaming_details_params
+          params[:path] = '/youtube/v3/videos'
+        end
+      end
+
+      def live_streaming_details_params
+        {max_results: 50, part: 'liveStreamingDetails', id: @parent.id}
+      end
+    end
+  end
+end

data/lib/yt/collections/ownerships.rb

@@ -0,0 +1,34 @@
+require 'yt/collections/resources'
+require 'yt/models/ownership'
+
+module Yt
+  module Collections
+    # Provides methods to interact with a the ownership of a YouTube resource.
+    #
+    # Resources with ownerships are: {Yt::Models::Asset assets}.
+    class Ownerships < Resources
+
+    private
+
+      def attributes_for_new_item(data)
+        {data: data, asset_id: @parent.id, auth: @auth}
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to get ownerships.
+      # @see https://developers.google.com/youtube/partner/docs/v1/ownership/get
+      def list_params
+        super.tap do |params|
+          params[:path] = "/youtube/partner/v1/assets/#{@parent.id}/ownership"
+          params[:params] = {on_behalf_of_content_owner: @auth.owner_name}
+        end
+      end
+
+      # @private
+      # @note Ownerships overwrites +fetch_page+ since it’s a get.
+      def fetch_page(params = {})
+        response = list_request(params).run
+        {items: [response.body], token: nil}
+      end
+    end
+  end
+end

data/lib/yt/collections/partnered_channels.rb

@@ -0,0 +1,28 @@
+require 'yt/collections/channels'
+
+module Yt
+  module Collections
+    class PartneredChannels < Channels
+
+    private
+
+      # @private
+      # @note Partnered Channels overwrites +channel_params+ since the query
+      #   is slightly different.
+      def channels_params
+        super.tap do |params|
+          params.delete :mine
+          params[:managed_by_me] = true
+          params[:on_behalf_of_content_owner] = @auth.owner_name
+        end
+      end
+
+      # @private
+      # @note Partnered Channels overwrites +list_resources+ since the endpoint
+      #   to hit is 'channels', not 'partnered_channels'.
+      def list_resources
+        self.class.superclass.to_s.demodulize
+      end
+    end
+  end
+end

data/lib/yt/collections/players.rb

@@ -0,0 +1,30 @@
+require 'yt/collections/base'
+require 'yt/models/player'
+
+module Yt
+  module Collections
+    # @private
+    class Players < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {data: data['player']}
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to get the
+      #   statistics of a resource, for instance a video.
+      # @see https://developers.google.com/youtube/v3/docs/videos#resource
+      def list_params
+        super.tap do |params|
+          params[:path] = "/youtube/v3/#{@parent.kind.pluralize}"
+          params[:params] = players_params
+        end
+      end
+
+      def players_params
+        {max_results: 50, part: 'player', id: @parent.id}
+      end
+    end
+  end
+end

data/lib/yt/collections/playlist_items.rb

@@ -0,0 +1,53 @@
+require 'yt/collections/resources'
+
+module Yt
+  module Collections
+    class PlaylistItems < Resources
+
+      def insert(attributes = {}, options = {})
+        super attributes.merge(playlist_id: @parent.id), options
+      rescue Yt::Error => error
+        ignorable_errors = error.reasons & ['videoNotFound', 'forbidden']
+        raise error unless options[:ignore_errors] && ignorable_errors.any?
+      end
+
+    private
+
+      def attributes_for_new_item(data)
+        snippet = data.fetch 'snippet', {}
+        data['snippet'].reverse_merge! complete: snippet.key?('position')
+        super(data).tap do |attributes|
+          attributes[:video] = data['video']
+        end
+      end
+
+      def eager_load_items_from(items)
+        if included_relationships.include?(:video)
+          video_ids = items.map{|item| item['snippet']['resourceId']['videoId']}.uniq
+          conditions = {id: video_ids.join(',')}
+          conditions[:part] = 'snippet,status,statistics'
+          videos = Collections::Videos.new(auth: @auth).where conditions
+          items.each do |item|
+            video = videos.find{|v| v.id == item['snippet']['resourceId']['videoId']}
+            item['video'] = video
+          end
+        end
+        super
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to list playlist items.
+      # @see https://developers.google.com/youtube/v3/docs/playlistItems/list
+      def list_params
+        super.tap{|params| params[:params] = playlist_items_params}
+      end
+
+      def playlist_items_params
+        resources_params.merge playlist_id: @parent.id
+      end
+
+      def insert_parts
+        {snippet: {keys: [:playlist_id, :resource_id, :position]}}
+      end
+    end
+  end
+end

data/lib/yt/collections/playlists.rb

@@ -0,0 +1,28 @@
+require 'yt/collections/resources'
+
+module Yt
+  module Collections
+    class Playlists < Resources
+
+    private
+
+      # @return [Hash] the parameters to submit to YouTube to list channels.
+      # @see https://developers.google.com/youtube/v3/docs/channels/list
+      def list_params
+        super.tap{|params| params[:params] = playlists_params}
+      end
+
+      def playlists_params
+        params = resources_params
+        params.merge! channel_id: @parent.id if @parent
+        apply_where_params! params
+      end
+
+      def insert_parts
+        snippet = {keys: [:title, :description, :tags], sanitize_brackets: true}
+        status = {keys: [:privacy_status]}
+        {snippet: snippet, status: status}
+      end
+    end
+  end
+end

data/lib/yt/collections/policies.rb

@@ -0,0 +1,28 @@
+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
+
+      # @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
+        apply_where_params! on_behalf_of_content_owner: @parent.owner_name
+      end
+    end
+  end
+end

data/lib/yt/collections/ratings.rb

@@ -0,0 +1,23 @@
+require 'yt/collections/base'
+require 'yt/models/rating'
+
+module Yt
+  module Collections
+    # @private
+    class Ratings < Base
+
+    private
+
+      def attributes_for_new_item(data)
+        {rating: data['rating'], video_id: @parent.id, auth: @auth}
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:path] = '/youtube/v3/videos/getRating'
+          params[:params] = {id: @parent.id}
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/references.rb

@@ -0,0 +1,46 @@
+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
+      def insert(attributes = {})
+        underscore_keys! attributes
+        body = attributes.slice(*body_params)
+        params = {claim_id: attributes[:claim_id], on_behalf_of_content_owner: @auth.owner_name}
+        do_insert(params: params, body: body)
+      end
+
+    private
+
+      # @return [Hash] the parameters to submit to YouTube to add a reference.
+      # @see https://developers.google.com/youtube/partner/docs/v1/references/insert
+      def insert_params
+        super.tap do |params|
+          params[:path] = '/youtube/partner/v1/references'
+        end
+      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
+        apply_where_params! on_behalf_of_content_owner: @parent.owner_name
+      end
+
+      def body_params
+        [:content_type, :audioswap_enabled, :ignore_fps_match, :excluded_intervals]
+      end
+    end
+  end
+end

data/lib/yt/collections/related_playlists.rb

@@ -0,0 +1,43 @@
+require 'yt/collections/playlists'
+
+module Yt
+  module Collections
+    class RelatedPlaylists < Playlists
+
+    private
+
+      # Retrieving related playlists requires to hit the /channels endpoint.
+      def list_resources
+        'channels'
+      end
+
+      # The related playlists are included in the content details of a channel.
+      def playlists_params
+        {part: 'contentDetails', id: @parent.id}
+      end
+
+      # The object to create is "Yt::Models::Playlist", not "RelatedPlaylist"
+      def resource_class
+        Yt::Models::Playlist
+      end
+
+      # The related playlists are nested inside the "relatedPlaylists" key.
+      def extract_items(list)
+        if (items = super).any?
+          items.first['contentDetails'].fetch 'relatedPlaylists', {}
+        end
+      end
+
+      # Since there are at most 5 related playlists, they can be eager-loaded.
+      def eager_load_items_from(items)
+        conditions = {id: items.values.join(','), part: 'snippet,status'}
+        Collections::Playlists.new(auth: @auth).where conditions
+      end
+
+      # Related playlists are eager-loaded, there’s no need to load them again.
+      def new_item(playlist)
+        playlist
+      end
+    end
+  end
+end