yt 0.34.0 → 0.34.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33ad5cd77351556b82e952d8475b978539d34cb7b82731f60b91dc000fd675ce
-  data.tar.gz: 373db01c5faa0076ea61b9e30f81f7959505ea423026dcc2aba227f8f6aacc13
+  metadata.gz: d762b0553bfa8bd58e917e9ff11a1f38958c3b072fe35f0a1e77f19aa48926d0
+  data.tar.gz: 2b50a350f9d9c13f067fde5f35e7dfaf0aee824bdf98f1399690c6eddd74a730
 SHA512:
-  metadata.gz: 0cb261d97cba17e75a42c49420784917bea7a9f6c257f08f928463db81f34784fce53c844d5744c6e72001bb4a600b94cef6592fd2e8ebc368118c5bcec1cb5b
-  data.tar.gz: 8af926d7f3341c7f3ffdd1b6a71554470fcd13d6fa7710e666eacf2e9968c76efedb5cdbf603ab792c0f076497fafa8e64364cb2a8355ad6b4475218950069b6
+  metadata.gz: 839ac9877b734b3254fd2224091e88d82797621183c5a6b1893d70181fe5fe0391b8ca3a5829b7074a8b694198221968ba2d1151a1d47cc8d7dd67f4fed26943
+  data.tar.gz: cec4e6c32178f4de39919271f3875012c9ea56233236029135bc4ea7b1113859871319e90491963e27047cb0f0916e999fdd9d02675fd1c3aa3d93f7917a24d9

data/CHANGELOG.md

@@ -6,6 +6,17 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.34.1 - 2026-01-08
+
+* [FEATURE] Add channel.channel_sections
+* [FEATURE] Add branding_setting.unsubscribed_trailer
+* [FEATURE] Add engaged_views
+* [FEATURE] Add account.sub (thank you @jkowens)
+* [FEATURE] Add content_owner.live_cuepoints
+* [FIX] Fetch channel_id from channel handle url
+* [BUGFIX] upload_thumbnail and upload_video with path url (thank you @mrj)
+* [IMPROVEMENT] Use `URI.decode_www_form` for Ruby 4.0 (thank you @jules-w2)
+
 ## 0.34.0 - 2024-08-25
 
 * Ruby 2.1+ required https://github.com/nullscreen/yt/pull/425

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2014–present Fullscreen, Inc.
+Copyright (c) 2014–present Nullscreen
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -17,4 +17,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/yt/actions/get.rb

@@ -14,7 +14,7 @@ module Yt
     private
 
       def get_request(params = {})
-        @list_request = Yt::Request.new(params).tap do |request|
+        @get_request = Yt::Request.new(params).tap do |request|
           print "#{request.as_curl}\n" if Yt.configuration.developing?
         end
       end
@@ -24,10 +24,10 @@ module Yt
           params[:method] = :get
           params[:host] = 'www.googleapis.com'
           params[:auth] = @auth
-          params[:exptected_response] = Net::HTTPOK
+          params[:expected_response] = Net::HTTPOK
           params[:api_key] = Yt.configuration.api_key if Yt.configuration.api_key
         end
       end
     end
   end
-end
+end

data/lib/yt/actions/insert.rb

@@ -39,4 +39,4 @@ module Yt
       end
     end
   end
-end
+end

data/lib/yt/actions/list.rb

@@ -117,7 +117,7 @@ module Yt
           params[:host] = 'www.googleapis.com'
           params[:auth] = @auth
           params[:path] = path
-          params[:exptected_response] = Net::HTTPOK
+          params[:expected_response] = Net::HTTPOK
           params[:api_key] = Yt.configuration.api_key if Yt.configuration.api_key
         end
       end

data/lib/yt/associations/has_authentication.rb

@@ -189,7 +189,7 @@ module Yt
           params[:redirect_uri] = @redirect_uri
           params[:response_type] = :code
           params[:access_type] = :offline
-          params[:approval_prompt] = @force ? :force : :auto
+          params[:prompt] = :consent if @force
           # params[:include_granted_scopes] = true
           params[:state] = @state if @state
         end

data/lib/yt/collections/branding_settings.rb

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

data/lib/yt/collections/channel_sections.rb

@@ -0,0 +1,45 @@
+require 'yt/collections/base'
+require 'yt/models/channel_section'
+
+module Yt
+  module Collections
+    # Provides methods for a collection of YouTube channel sections.
+    #
+    # Resources with channel_sections is {Yt::Models::Channel channels}.
+    class ChannelSections < Base
+
+      def attributes_for_new_item(data)
+        {}.tap do |attributes|
+          attributes[:id] = data['id']
+          attributes[:snippet] = data['snippet']
+          attributes[:content_details] = data['contentDetails']
+        end
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to list channel sections.
+      # @see https://developers.google.com/youtube/v3/docs/channelSections/list
+      def list_params
+        super.tap do |params|
+          params[:params] = channel_sections_params
+          params[:path] = '/youtube/v3/channelSections'
+        end
+      end
+
+      def channel_sections_params
+        {}.tap do |params|
+          params[:part] = 'snippet'
+          params.merge! @parent.channel_sections_params if @parent
+          # TODO: when to mine, when to on_behalf_of_content_owner
+          # if @parent.auth
+          #   if @parent.auth.owner_name
+          #     params[:on_behalf_of_content_owner] = @parent.auth.owner_name
+          #   else
+          #     params[:mine] = true
+          #   end
+          # end
+          params
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/live_cuepoints.rb

@@ -0,0 +1,37 @@
+require 'yt/collections/base'
+require 'yt/models/live_cuepoint'
+
+module Yt
+  module Collections
+    # Provides methods to insert live cuepoints.
+    #
+    # Resources with live_cuepoints are: {Yt::Models::ContentOwner content owners}.
+    class LiveCuepoints < Base
+      def insert(attributes = {})
+        underscore_keys! attributes
+        body = attributes.slice(*body_params)
+        params = {on_behalf_of_content_owner: @auth.owner_name}
+        apply_where_params! params
+        do_insert(params: params, body: body)
+      end
+
+      private
+
+      def body_params
+        [:id, :cue_type, :insertion_offset_time_ms, :walltime_ms, :duration_secs]
+      end
+
+      # @return [Hash] the parameters to submit to YouTube to add a live cuepoint.
+      # @see https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/cuepoint
+      def insert_params
+        super.tap do |params|
+          params[:path] = '/youtube/v3/liveBroadcasts/cuepoint'
+        end
+      end
+
+      def attributes_for_new_item(data)
+        {data: data, auth: @auth, id: data['id']}
+      end
+    end
+  end
+end

data/lib/yt/collections/reports.rb

@@ -47,19 +47,28 @@ module Yt
         playlist_page: 'YT_PLAYLIST_PAGE',
         campaign_card: 'CAMPAIGN_CARD',
         end_screen: 'END_SCREEN',
-        info_card: 'INFO_CARD'
+        info_card: 'INFO_CARD',
+        hashtags: 'HASHTAGS',
+        live_redirect: 'LIVE_REDIRECT',
+        product_page: 'PRODUCT_PAGE',
+        shorts: 'SHORTS',
+        sound_page: 'SOUND_PAGE',
+        video_remixes: 'VIDEO_REMIXES',
+        immersive_live: 'IMMERSIVE_LIVE',
+        shorts_content_links: 'SHORTS_CONTENT_LINKS'
       }
 
-      # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Location_Dimensions
+      # @see https://developers.google.com/youtube/analytics/dimensions#Playback_Location_Dimensions
       PLAYBACK_LOCATIONS = {
         channel: 'CHANNEL',
         watch: 'WATCH',
         embedded: 'EMBEDDED',
         other: 'YT_OTHER',
         external_app: 'EXTERNAL_APP',
-        search: 'SEARCH', # undocumented but returned by the API
-        browse: 'BROWSE', # undocumented but returned by the API
-        mobile: 'MOBILE' # only present for data < September 10, 2013
+        search: 'SEARCH',
+        browse: 'BROWSE',
+        mobile: 'MOBILE', # only present for data < September 10, 2013
+        shorts_feed: 'SHORTS_FEED' # undocumented but returned by the API
       }
 
       # @see https://developers.google.com/youtube/analytics/v1/dimsmets/dims#Playback_Detail_Dimensions
@@ -203,7 +212,6 @@ module Yt
           params[:filters] = ((params[:filters] || '').split(';') + ["country==US"]).compact.uniq.join(';') if @dimension == :state && !@state
           params[:filters] = ((params[:filters] || '').split(';') + ["country==#{@country}"]).compact.uniq.join(';') if @country && !@state
           params[:filters] = ((params[:filters] || '').split(';') + ["province==US-#{@state}"]).compact.uniq.join(';') if @state
-          params[:filters] = ((params[:filters] || '').split(';') + ['isCurated==1']).compact.uniq.join(';') if @dimension == :playlist
           params[:filters] = ((params[:filters] || '').split(';') + ['insightPlaybackLocationType==EMBEDDED']).compact.uniq.join(';') if @dimension == :embedded_player_location
           params[:filters] = ((params[:filters] || '').split(';') + ['insightTrafficSourceType==RELATED_VIDEO']).compact.uniq.join(';') if @dimension == :related_video
           params[:filters] = ((params[:filters] || '').split(';') + ['insightTrafficSourceType==YT_SEARCH']).compact.uniq.join(';') if @dimension == :search_term

data/lib/yt/models/account.rb

@@ -1,3 +1,4 @@
+require 'open-uri'
 require 'yt/models/base'
 
 module Yt
@@ -14,6 +15,10 @@ module Yt
       #   @return [String] the (Google+) account’s ID.
       delegate :id, to: :user_info
 
+      # @!attribute [r] sub
+      #   @return [String] the (Google) account’s unique ID.
+      delegate :sub, to: :user_info
+
       # @!attribute [r] email
       #   @return [String] the account’s email address.
       delegate :email, to: :user_info

data/lib/yt/models/branding_setting.rb

@@ -0,0 +1,29 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # @private
+    # Encapsulates branding settings about the resource, such as trailer on channel
+    # @see https://developers.google.com/youtube/v3/docs/channels#resource-representation
+    class BrandingSetting < Base
+      attr_reader :data
+
+      def initialize(options = {})
+        @data = options[:data]
+      end
+
+      has_attribute :channel, default: {}
+
+      def unsubscribed_trailer
+        channel['unsubscribedTrailer']
+      end
+
+      has_attribute :image, default: {}
+
+      def banner_external_url
+        image['bannerExternalUrl']
+      end
+    end
+  end
+end
+

data/lib/yt/models/caption.rb

@@ -1,4 +1,5 @@
 require 'yt/models/resource'
+require "fileutils"
 
 module Yt
   module Models
@@ -14,6 +15,38 @@ module Yt
       delegate :language, to: :snippet
       delegate :name, to: :snippet
       delegate :status, to: :snippet
+
+      # Downloads a caption file.
+      # @param [String] path A name for the downloaded file with caption content.
+      # @see https://developers.google.com/youtube/v3/docs/captions#resource
+      def download(path)
+        case io
+        when StringIO then File.open(path, 'w') { |f| f.write(io.read) }
+        when Tempfile then io.close; FileUtils.mv(io.path, path)
+        end
+      end
+
+      def io
+        @io ||= get_request(download_params).open_uri
+      end
+
+    private
+
+      # @return [Hash] the parameters to submit to YouTube to download caption.
+      # @see https://developers.google.com/youtube/v3/docs/captions/download
+      def download_params
+        {}.tap do |params|
+          params[:method] = :get
+          params[:host] = 'youtube.googleapis.com'
+          params[:auth] = @auth
+          params[:exptected_response] = Net::HTTPOK
+          params[:api_key] = Yt.configuration.api_key if Yt.configuration.api_key
+          params[:path] = "/youtube/v3/captions/#{@id}"
+          if @auth.owner_name
+            params[:params] = {on_behalf_of_content_owner: @auth.owner_name}
+          end
+        end
+      end
     end
   end
 end

data/lib/yt/models/channel.rb

@@ -126,6 +126,10 @@ module Yt
       #     explicitly select the option to keep all subscriptions private.
       has_many :subscribed_channels
 
+      # @!attribute [r] channel_sections
+      #   @return [Yt::Collections::ChannelSections] the channel’s channel sections.
+      has_many :channel_sections
+
     ### ANALYTICS ###
 
       # @macro reports
@@ -133,6 +137,9 @@ module Yt
       # @macro report_by_channel_dimensions
       has_report :views, Integer
 
+      # @macro report_by_channel_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_channel_dimensions
       has_report :estimated_minutes_watched, Integer
 
@@ -229,6 +236,18 @@ module Yt
         statistics_set.hidden_subscriber_count == false
       end
 
+    ### BRANDING SETTINGS ###
+
+      has_one :branding_setting
+
+      # @!attribute [r] unsubscribed_trailer
+      #   @return [String] the channel’s trailer video id.
+      delegate :unsubscribed_trailer, to: :branding_setting
+
+      # @!attribute [r] banner_external_url
+      #   @return [String] the channel’s banner image URL.
+      delegate :banner_external_url, to: :branding_setting
+
     ### CONTENT OWNER DETAILS ###
 
       has_one :content_owner_detail
@@ -286,6 +305,16 @@ module Yt
         if options[:content_owner_details]
           @content_owner_detail = ContentOwnerDetail.new data: options[:content_owner_details]
         end
+        if options[:branding_settings]
+          @branding_setting = BrandingSetting.new data: options[:branding_settings]
+        end
+      end
+
+      # @private
+      # Used for `has_many :channel_sections` to return all youtube#channelSection items
+      # of the channel.
+      def channel_sections_params
+        {channel_id: id}
       end
 
       # @private

data/lib/yt/models/channel_section.rb

@@ -0,0 +1,25 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    class ChannelSection < Base
+      attr_reader :data
+
+      # @private
+      def initialize(options = {})
+        @id = options[:id]
+        @data = options[:snippet]
+      end
+
+      has_attribute :type
+      has_attribute :channel_id
+      has_attribute :position, type: Integer
+
+    ### ID ###
+
+      # @!attribute [r] id
+      #   @return [String] the ID that YouTube uses to identify each resource.
+      attr_reader :id
+    end
+  end
+end

data/lib/yt/models/content_owner.rb

@@ -11,6 +11,10 @@ module Yt
       #   @return [Yt::Collections::PartneredChannels] the channels managed by the CMS account.
       has_many :partnered_channels
 
+      # @!attribute [r] live_cuepoints
+      #   @return [Yt::Collections::LiveCuepoints] the live_cuepoints inserted by the content owner.
+      has_many :live_cuepoints
+
       # @!attribute [r] claims
       #   @return [Yt::Collections::Claims] the claims administered by the content owner.
       has_many :claims

data/lib/yt/models/group_info.rb

@@ -13,4 +13,4 @@ module Yt
       has_attribute :published_at, type: Time
     end
   end
-end
+end

data/lib/yt/models/live_cuepoint.rb

@@ -0,0 +1,23 @@
+require 'yt/models/base'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube Content ID live cuepoints.
+    # @see https://developers.google.com/youtube/v3/live/docs/liveCuepoints
+    class LiveCuepoint < Base
+      def initialize(options = {})
+        @data = options[:data]
+        @id = options[:id]
+        @auth = options[:auth]
+      end
+
+      # @return [String] the ID that YouTube assigns and uses to uniquely
+      #   identify the live_cuepoint.
+      has_attribute :id
+
+      # @return [String] the ID that uniquely identifies the broadcast that the
+      #   live_cuepoint is associated with.
+      has_attribute :broadcast_id
+    end
+  end
+end

data/lib/yt/models/playlist.rb

@@ -160,6 +160,9 @@ module Yt
       # @macro report_by_playlist_dimensions
       has_report :views, Integer
 
+      # @macro report_by_playlist_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_playlist_dimensions
       has_report :estimated_minutes_watched, Integer
 
@@ -202,7 +205,7 @@ module Yt
           else
             params[:ids] = "channel==#{channel_id}"
           end
-          params[:filters] = "playlist==#{id};isCurated==1"
+          params[:filters] = "playlist==#{id}"
         end
       end
 

data/lib/yt/models/reference.rb

@@ -169,4 +169,4 @@ module Yt
       end
     end
   end
-end
+end

data/lib/yt/models/resource.rb

@@ -12,13 +12,7 @@ module Yt
 
       # @!attribute [r] id
       #   @return [String] the ID that YouTube uses to identify each resource.
-      def id
-        if @id.nil? && @match && @match[:kind] == :channel
-          @id ||= fetch_channel_id
-        else
-          @id
-        end
-      end
+      attr_reader :id
 
     ### STATUS ###
 
@@ -51,7 +45,11 @@ module Yt
         if options[:url]
           @url = options[:url]
           @match = find_pattern_match
-          @id = @match['id']
+          if kind == "channel" && @match.key?('format')
+            @id ||= fetch_channel_id
+          else
+            @id = @match['id']
+          end
         else
           @id = options[:id]
         end
@@ -98,7 +96,8 @@ module Yt
       # @return [Array<Regexp>] patterns matching URLs of YouTube channels.
       CHANNEL_PATTERNS = [
         %r{^(?:https?://)?(?:www\.)?youtube\.com/channel/(?<id>UC[a-zA-Z0-9_-]{22})},
-        %r{^(?:https?://)?(?:www\.)?youtube\.com/(?<format>c/|user/)?(?<name>[a-zA-Z0-9_-]+)}
+        %r{^(?:https?://)?(?:www\.)?youtube\.com/(?<format>c/|user/)?(?<name>[a-zA-Z0-9_-]+)},
+        %r{^(?:https?://)?(?:www\.)?youtube\.com/(?<format>@)(?<name>[a-zA-Z0-9_-]+)}
       ]
 
     private
@@ -106,8 +105,7 @@ module Yt
       def find_pattern_match
         patterns.find do |kind, regex|
           if data = @url.match(regex)
-            # Note: With Ruby 2.4, the following is data.named_captures
-            break data.names.zip(data.captures).to_h.merge kind: kind
+            break data.named_captures.merge kind: kind
           end
         end || {kind: :unknown}
       end
@@ -123,19 +121,44 @@ module Yt
       end
 
       def fetch_channel_id
-        response = Net::HTTP.start 'www.youtube.com', 443, use_ssl: true do |http|
-          http.request Net::HTTP::Get.new("/#{@match['format']}#{@match['name']}")
-        end
-        if response.is_a?(Net::HTTPRedirection)
+        api_key = Yt.configuration.api_key if Yt.configuration.api_key
+        case @match['format']
+        when "@"
+          handle = "@#{@match['name']}"
+          response = Net::HTTP.start 'youtube.googleapis.com', 443, use_ssl: true do |http|
+            http.request Net::HTTP::Get.new("/youtube/v3/channels?part=snippet&forHandle=#{handle}&key=#{api_key}")
+          end
+          if response.is_a?(Net::HTTPOK) && item = JSON(response.body)['items']&.first
+            item['id']
+          else
+            raise Yt::Errors::NoItems
+          end
+        when "user/"
+          username = @match['name']
+          response = Net::HTTP.start 'youtube.googleapis.com', 443, use_ssl: true do |http|
+            http.request Net::HTTP::Get.new("/youtube/v3/channels?part=snippet&forUsername=#{username}&key=#{api_key}")
+          end
+          if response.is_a?(Net::HTTPOK) && item = JSON(response.body)['items']&.first
+            item['id']
+          else
+            raise Yt::Errors::NoItems
+          end
+        else # "c/", nil
           response = Net::HTTP.start 'www.youtube.com', 443, use_ssl: true do |http|
-            http.request Net::HTTP::Get.new(response['location'])
+            http.request Net::HTTP::Get.new("/#{@match['format']}#{@match['name']}")
+          end
+          if response.is_a?(Net::HTTPRedirection)
+            response = Net::HTTP.start 'www.youtube.com', 443, use_ssl: true do |http|
+              http.request Net::HTTP::Get.new(response['location'])
+            end
+          end
+          # puts response.body
+          regex = %r{(?<id>UC[a-zA-Z0-9_-]{22})}
+          if data = response.body.match(regex)
+            data[:id]
+          else
+            raise Yt::Errors::NoItems
           end
-        end
-        regex = %r{<meta itemprop="channelId" content="(?<id>UC[a-zA-Z0-9_-]{22})">}
-        if data = response.body.match(regex)
-          data[:id]
-        else
-          raise Yt::Errors::NoItems
         end
       end
 

data/lib/yt/models/resumable_session.rb

@@ -1,4 +1,3 @@
-require 'cgi'
 require 'yt/models/base'
 
 module Yt
@@ -30,7 +29,7 @@ module Yt
     private
 
       def session_params
-        CGI::parse(@uri.query).tap{|hash| hash.each{|k,v| hash[k] = v.first}}
+        URI.decode_www_form(@uri.query || "").to_h
       end
 
       # @note: YouTube documentation states that a valid upload returns an HTTP

data/lib/yt/models/user_info.rb

@@ -11,6 +11,7 @@ module Yt
       end
 
       has_attribute :id, default: ''
+      has_attribute :sub, default: ''
       has_attribute :email, default: ''
       has_attribute :verified_email, default: false, camelize: false
       has_attribute :name, default: ''

data/lib/yt/models/video.rb

@@ -1,3 +1,4 @@
+require 'open-uri'
 require 'yt/models/resource'
 
 module Yt
@@ -421,6 +422,9 @@ module Yt
       # @macro report_by_video_dimensions
       has_report :views, Integer
 
+      # @macro report_by_video_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_video_dimensions
       has_report :estimated_minutes_watched, Integer
 
@@ -546,7 +550,7 @@ module Yt
       # @raise [Yt::Errors::RequestError] if path_or_url is not a valid path
       #   or URL.
       def upload_thumbnail(path_or_url)
-        file = URI.open(path_or_url) rescue StringIO.new
+        file = URI.open(path_or_url)
         session = resumable_sessions.insert file.size
 
         session.update(body: file) do |data|

data/lib/yt/models/video_group.rb

@@ -37,6 +37,9 @@ module Yt
       # @macro report_by_video_dimensions
       has_report :views, Integer
 
+      # @macro report_by_video_dimensions
+      has_report :engaged_views, Integer
+
       # @macro report_by_video_dimensions
       has_report :estimated_minutes_watched, Integer
 

data/lib/yt/request.rb

@@ -1,6 +1,7 @@
 require 'net/http' # for Net::HTTP.start
 require 'uri' # for URI.json
 require 'json' # for JSON.parse
+require "open-uri" # for URI.open
 require 'active_support' # does not load anything by default, but is required
 require 'active_support/core_ext' # for Hash.from_xml, Hash.to_param
 
@@ -84,6 +85,10 @@ module Yt
       end
     end
 
+    def open_uri
+      URI.open(uri.to_s, 'Authorization' => "Bearer #{@auth.access_token}")
+    end
+
     # Returns the +cURL+ version of the request, useful to re-run the request
     # in a shell terminal.
     # @return [String] the +cURL+ version of the request.

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.34.0'
+  VERSION = '0.34.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.34.1
 platform: ruby
 authors:
-- Claudio Baccigalupo
+- Nullscreen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-10 00:00:00.000000000 Z
+date: 2026-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -24,20 +24,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -52,34 +38,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
@@ -110,27 +68,16 @@ dependencies:
         version: '0'
 description: Youtube V3 API client.
 email:
-- claudio@fullscreen.net
-executables:
-- console
-- yt
+- nullscreen.code@gmail.com
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
 - ".yardopts"
 - CHANGELOG.md
-- Gemfile
 - MIT-LICENSE
 - README.md
-- Rakefile
 - YOUTUBE_IT.md
-- bin/console
-- bin/yt
-- gemfiles/Gemfile.activesupport-3.x
-- gemfiles/Gemfile.activesupport-4.x
 - lib/yt.rb
 - lib/yt/actions/base.rb
 - lib/yt/actions/delete.rb
@@ -151,9 +98,11 @@ files:
 - lib/yt/collections/assets.rb
 - lib/yt/collections/authentications.rb
 - lib/yt/collections/base.rb
+- lib/yt/collections/branding_settings.rb
 - lib/yt/collections/bulk_report_jobs.rb
 - lib/yt/collections/bulk_reports.rb
 - lib/yt/collections/captions.rb
+- lib/yt/collections/channel_sections.rb
 - lib/yt/collections/channels.rb
 - lib/yt/collections/claim_histories.rb
 - lib/yt/collections/claims.rb
@@ -165,6 +114,7 @@ files:
 - lib/yt/collections/file_details.rb
 - lib/yt/collections/group_infos.rb
 - lib/yt/collections/group_items.rb
+- lib/yt/collections/live_cuepoints.rb
 - lib/yt/collections/live_streaming_details.rb
 - lib/yt/collections/ownerships.rb
 - lib/yt/collections/partnered_channels.rb
@@ -205,10 +155,12 @@ files:
 - lib/yt/models/asset_snippet.rb
 - lib/yt/models/authentication.rb
 - lib/yt/models/base.rb
+- lib/yt/models/branding_setting.rb
 - lib/yt/models/bulk_report.rb
 - lib/yt/models/bulk_report_job.rb
 - lib/yt/models/caption.rb
 - lib/yt/models/channel.rb
+- lib/yt/models/channel_section.rb
 - lib/yt/models/claim.rb
 - lib/yt/models/claim_event.rb
 - lib/yt/models/claim_history.rb
@@ -223,6 +175,7 @@ files:
 - lib/yt/models/group_info.rb
 - lib/yt/models/group_item.rb
 - lib/yt/models/id.rb
+- lib/yt/models/live_cuepoint.rb
 - lib/yt/models/live_streaming_detail.rb
 - lib/yt/models/match_policy.rb
 - lib/yt/models/ownership.rb
@@ -249,8 +202,7 @@ files:
 - lib/yt/models/video_group.rb
 - lib/yt/request.rb
 - lib/yt/version.rb
-- yt.gemspec
-homepage: http://github.com/Fullscreen/yt
+homepage: http://github.com/nullscreen/yt
 licenses:
 - MIT
 metadata: {}
@@ -269,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
+rubygems_version: 3.4.20
 signing_key:
 specification_version: 4
 summary: Yt makes it easy to interact with Youtube V3 API by providing a modular,

data/.gitignore

@@ -1,27 +0,0 @@
-# See http://help.github.com/ignore-files/ for more about ignoring files.
-#
-# If you find yourself ignoring temporary files generated by your text editor
-# or operating system, you probably want to add a global ignore instead:
-#   git config --global core.excludesfile '~/.gitignore_global'
-
-# Ignore bundler config.
-/.bundle
-
-# Ignore the default SQLite database.
-/db/*.sqlite3
-/db/*.sqlite3-journal
-
-coverage/
-Gemfile.lock
-
-# Ignore all logfiles and tempfiles.
-/log/*.log
-/tmp
-**/tmp
-*.gem
-*.sqlite3
-
-doc/
-.yardoc/
-_site/
-TODO.md

data/.rspec

@@ -1,3 +0,0 @@
---color
---exclude_pattern spec/requests/as_content_owner/*_spec.rb
---tag=~slow

data/.travis.yml

@@ -1,7 +0,0 @@
-language: ruby
-notifications:
-  email: true
-matrix:
-  include:
-  - rvm: 2.6.3
-    gemfile: gemfiles/Gemfile.activesupport-4.x

data/Gemfile

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

data/Rakefile

@@ -1,11 +0,0 @@
-require "bundler"
-Bundler.setup
-Bundler::GemHelper.install_tasks
-
-require "rspec/core/rake_task"
-require "rspec/core/version"
-
-desc "Run all examples"
-RSpec::Core::RakeTask.new :spec
-
-task default: [:spec]

data/bin/console

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "yt"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-require "pry"
-Pry.start
-
-# require "irb"
-# IRB.start(__FILE__)

data/bin/yt

@@ -1,23 +0,0 @@
-#!/usr/bin/env ruby
-
-begin
-  require 'yt'
-rescue LoadError
-  require 'rubygems'
-  require 'yt'
-end
-
-Yt.configuration.log_level = :debug
-id = ARGV[1] || 'rdwz7QiG0lk'
-
-case ARGV[0]
-when 'info'
-  puts "Yt version #{Yt::VERSION}"
-  video = Yt::Video.new id: id
-  puts video.title
-when 'video'
-  video = Yt::Video.new id: id
-  views = "#{video.view_count} #{'view'.pluralize video.view_count}"
-  likes = "#{video.like_count} #{'like'.pluralize video.like_count}"
-  puts "'#{video.title}' by #{video.channel_title} has #{views} and #{likes}"
-end

data/gemfiles/Gemfile.activesupport-3.x

@@ -1,4 +0,0 @@
-source 'http://rubygems.org'
-
-gem 'activesupport', '~> 3.0'
-gemspec path: '../'

data/gemfiles/Gemfile.activesupport-4.x

@@ -1,4 +0,0 @@
-source 'http://rubygems.org'
-
-gem 'activesupport', '~> 4.0'
-gemspec path: '../'

data/yt.gemspec

@@ -1,36 +0,0 @@
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'yt/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "yt"
-  spec.version       = Yt::VERSION
-  spec.authors       = ["Claudio Baccigalupo"]
-  spec.email         = ["claudio@fullscreen.net"]
-  spec.description   = %q{Youtube V3 API client.}
-  spec.summary       = %q{Yt makes it easy to interact with Youtube V3 API by
-    providing a modular, intuitive and tested Ruby-style API.}
-  spec.homepage      = "http://github.com/Fullscreen/yt"
-  spec.license       = "MIT"
-
-  spec.required_ruby_version = '>= 2.1'
-
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  end
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency 'activesupport'
-
-  # For development / Code coverage / Documentation
-  spec.add_development_dependency 'bundler'
-  spec.add_development_dependency 'rspec'
-  spec.add_development_dependency 'rake'
-  # spec.add_development_dependency 'yard'
-  # spec.add_development_dependency 'coveralls'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'vcr'
-  spec.add_development_dependency 'webmock'
-end