Captions associated with a video

.gitignore

@@ -25,3 +25,5 @@ doc/
 .yardoc/
 _site/
 TODO.md
+
+spec/cassettes

README.md

@@ -56,7 +56,7 @@ Available resources
 Yt::Account
 -----------
 
-Check [fullscreen.github.io/yt](http://fullscreen.github.io/yt/accounts.html) for the list of methods available for `Yt::Account`.
+Check [nullscreen.github.io/yt](http://nullscreen.github.io/yt/accounts.html) for the list of methods available for `Yt::Account`.
 
 
 Yt::ContentOwner

bin/console

@@ -0,0 +1,15 @@
+#!/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__)

lib/yt.rb

@@ -14,6 +14,7 @@
 require 'yt/models/comment_thread'
 require 'yt/models/ownership'
 require 'yt/models/advertising_options_set'
+require 'yt/models/caption'
 
 # An object-oriented Ruby client for YouTube.
 # Helps creating applications that need to interact with YouTube objects.

lib/yt/collections/captions.rb

@@ -0,0 +1,30 @@
+require 'yt/collections/base'
+
+module Yt
+  module Collections
+    # Provides methods to interact with a collection of video captions.
+    class Captions < Resources
+
+      private
+
+      def attributes_for_new_item(data)
+        {id: data['id'], snippet: data['snippet'], auth: @auth}
+      end
+
+      def list_params
+        super.tap do |params|
+          params[:path] = "/youtube/v3/captions"
+          params[:params] = captions_params
+        end
+      end
+
+      def captions_params
+        {}.tap do |params|
+          params[:part] = 'snippet'
+          params[:video_id] = @parent.id if @parent
+          apply_where_params! params
+        end
+      end
+    end
+  end
+end

lib/yt/models/caption.rb

@@ -0,0 +1,19 @@
+require 'yt/models/resource'
+
+module Yt
+  module Models
+    # Provides methods to interact with YouTube video captions.
+    # @see https://developers.google.com/youtube/v3/docs/captions
+    class Caption < Resource
+
+      # @return [String] the ID used to identify the caption.
+      has_attribute :id
+
+      delegate :video_id, to: :snippet
+      delegate :last_updated, to: :snippet
+      delegate :language, to: :snippet
+      delegate :name, to: :snippet
+      delegate :status, to: :snippet
+    end
+  end
+end

lib/yt/models/snippet.rb

@@ -38,6 +38,11 @@ def initialize(options = {})
       has_attribute :like_count, type: Integer
       has_attribute :updated_at, type: Time
 
+      has_attribute :last_updated, type: Time
+      has_attribute :language
+      has_attribute :name
+      has_attribute :status
+
       def thumbnail_url(size = :default)
         thumbnails.fetch(size.to_s, {})['url']
       end

lib/yt/models/video.rb

@@ -533,6 +533,10 @@ def claim
       #     player that will play the video.
       delegate :embed_html, to: :player
 
+    ### CAPTION ###
+
+      has_many :captions
+
     ### ACTIONS (UPLOAD, UPDATE, DELETE) ###
 
       # Uploads a thumbnail