yt 0.32.3 → 0.32.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13d05d40be2a978569b4d9d95088169b27efbca654c6ac31e8cc80d404a2ccc3
-  data.tar.gz: 5ac7a2bf2c181a01f4f94af8399e1b5896160f4f60964cc8f12f02ab61688e5f
+  metadata.gz: b60bee886ed9551a6b9590fa99ad1146472dc90d332a50854a0d7ba490b40f93
+  data.tar.gz: 72e08ae6b64e508e873a1d47f00c71e021d994bfb3bb65b2c1b52e4e6709950a
 SHA512:
-  metadata.gz: fc36a64935d1888ee29a6e93bf076a020d249598564117ad8da8df71eadefd4c0030ccb9f213ef9537f2a7f4428d2a37084b8e72126a7ac2c8e4e00772fc818c
-  data.tar.gz: 7442494554ac18854f428149a591cf4f36eacce42b0c9f78053f2ff4cad792bb99f95bb1bfd963c49b5046357515ebd28fe67ecac62338999e933a1e8cfed289
+  metadata.gz: 87f08494b156a1846e63eff41c154cbfc462e1a65c1391bdc530ae1a84ef891150b72b0e604359a2d20d45a5fd0db88a7429c38ffa80b3a2f721b25452ebd119
+  data.tar.gz: 0453b6e46b53d2c3b2c0ffcdccd0daba325c97f96ebfacb37939172e6137c271236f94ef2fc05d25a6df3b8784c84040ab4b71064ea861b10e90e201a3198128

data/.rspec

@@ -1,3 +1,6 @@
 --format documentation
 --color
---fail-fast
+--tag ~rate_limited
+--tag ~flaky
+--tag ~extended_permissions
+--exclude_pattern spec/requests/as_content_owner/*_spec.rb

data/.travis.yml

@@ -3,7 +3,5 @@ notifications:
   email: true
 matrix:
   include:
-  - rvm: 1.9.3
-    gemfile: gemfiles/Gemfile.activesupport-3.x
-  - rvm: 2.0.0
-    gemfile: gemfiles/Gemfile.activesupport-4.x
+  - rvm: 2.6.3
+    gemfile: gemfiles/Gemfile.activesupport-4.x

data/CHANGELOG.md

@@ -6,6 +6,15 @@ For more information about changelogs, check
 [Keep a Changelog](http://keepachangelog.com) and
 [Vandamme](http://tech-angels.github.io/vandamme).
 
+## 0.32.4 - 2019-06-26
+
+* [FEATURE] Add `ownership_effective` method to access asset ownership ("effective") via the asset object.
+* [FEATURE] List content owners of others with `content_owner.content_owners`
+* [FEATURE] Add `match_info` to insert claim request.
+* [FEATURE] Add `upload_reference_file` method for Reference file upload (thank you @jcohenho)
+* [FEATURE] Get one asset [by request](https://developers.google.com/youtube/partner/docs/v1/assets/get) (thank you @jcohenho)
+* [FEATURE] Add `update` method to Yt::Claim (thank you @jcohenho)
+
 ## 0.32.3 - 2019-03-15
 
 * [ENHANCEMENT] Add `Yt::URL` to get id, kind, and its resource (channel, video, playlist)

data/README.md

@@ -8,7 +8,7 @@ The **source code** is available on [GitHub](https://github.com/Fullscreen/yt) a
 [![Build Status](http://img.shields.io/travis/Fullscreen/yt/master.svg)](https://travis-ci.org/Fullscreen/yt)
 [![Coverage Status](http://img.shields.io/coveralls/Fullscreen/yt/master.svg)](https://coveralls.io/r/Fullscreen/yt)
 [![Dependency Status](http://img.shields.io/gemnasium/Fullscreen/yt.svg)](https://gemnasium.com/Fullscreen/yt)
-[![Code Climate](http://img.shields.io/codeclimate/github/Fullscreen/yt.svg)](https://codeclimate.com/github/Fullscreen/yt)
+[![Code Climate](https://codeclimate.com/github/Fullscreen/yt.png)](https://codeclimate.com/github/Fullscreen/yt)
 [![Online docs](http://img.shields.io/badge/docs-✓-green.svg)](http://www.rubydoc.info/gems/yt/frames)
 [![Gem Version](http://img.shields.io/gem/v/yt.svg)](http://rubygems.org/gems/yt)
 
@@ -44,7 +44,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the Gemfile:
 
-    gem 'yt', '~> 0.28.0'
+    gem 'yt', '~> 0.32.0'
 
 Since the gem follows [Semantic Versioning](http://semver.org),
 indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
@@ -266,6 +266,11 @@ asset = content_owner.assets.where(id: 'A969176766549462', fetch_metadata: 'effe
 asset.metadata_effective.title #=> "Neu la anh" (different due to ownership conflicts)
 ```
 
+```ruby
+asset = content_owner.assets.where(id: 'A125058570526569', fetch_ownership: 'effective').first
+asset.ownership_effective.general_owners.first.owner # => "XOuN81q-MeEUVrsiZeK1lQ"
+```
+
 * to search for an asset
 
 ```ruby
@@ -295,6 +300,32 @@ claim.claim_history #=> #<Yt::Models::ClaimHistory ...>
 claim.claim_history.events[0].type #=> "claim_create"
 
 claim.delete #=> true
+
+data = {
+  is_manual_claim: true,
+  content_type: 'audiovisual',
+  asset_id: 'A123123123123123',
+  policy: { id: 'S123123123123123' },
+  video_id: 'myvIdeoIdYT',
+  match_info: {
+    match_segments: [
+      {
+        manual_segment: {
+          start: '00:00:20.000',
+          finish: '00:01:20.000'
+        }
+      },
+      {
+        manual_segment: {
+          start: '00:02:30.000',
+          finish: '00:03:50.000'
+        }
+      }
+    ]
+  }
+}
+
+content_owner.claims.insert(data)
 ```
 
 *The methods above require to be authenticated as the video’s content owner (see below).*
@@ -492,23 +523,6 @@ end
 so use the approach that you prefer.
 If a variable is set in both places, then `Yt.configure` takes precedence.
 
-Why you should use Yt…
-======================
-
-… and not [youtube_it](https://github.com/kylejginavan/youtube_it)?
-Because youtube_it does not support YouTube API V3, and the YouTube API V2 has
-been [officially deprecated as of March 4, 2014](https://developers.google.com/youtube/2.0/developers_guide_protocol_audience).
-If you need help upgrading your code, check [YOUTUBE_IT.md](https://github.com/Fullscreen/yt/blob/master/YOUTUBE_IT.md),
-a step-by-step comparison between youtube_it and Yt to make upgrade easier.
-
-… and not [Google Api Client](https://github.com/google/google-api-ruby-client)?
-Because Google Api Client is poorly coded, poorly documented and adds many
-dependencies, bloating the size of your project.
-
-… and not your own code? Because Yt is fully tested, well documented,
-has few dependencies and helps you forget about the burden of dealing with
-Google API!
-
 How to test
 ===========
 
@@ -517,15 +531,6 @@ Yt comes with two different sets of tests:
 1. tests in `spec/models`, `spec/collections` and `spec/errors` **do not hit** the YouTube API
 1. tests in `spec/requests` **hit** the YouTube API and require authentication
 
-The reason why some tests actually hit the YouTube API is because they are
-meant to really integrate Yt with YouTube. YouTube API is not exactly
-*the most reliable* API out there, so we need to make sure that the responses
-match the documentation.
-
-You don’t have to run all the tests every time you change code.
-Travis CI is already set up to do this for when whenever you push a branch
-or create a pull request for this project.
-
 To only run tests against models, collections and errors (which do not hit the API), type:
 
 ```bash
@@ -539,8 +544,26 @@ rspec
 ```
 
 This will fail unless you have set up a test YouTube application and some
-tests YouTube accounts to hit the API. Once again, you probably don’t need
-this, since Travis CI already takes care of running this kind of tests.
+tests YouTube accounts (with appropriate fixture data) to hit the API.
+Furthermore, tests that require authentication are divided into three
+roles, which correspond to each directory in `spec/requests`:
+
+* Account-based tests, which require a valid refresh token along with
+  the application-level credentials the refresh token was created with
+  (`YT_TEST_DEVICE_REFRESH_TOKEN`, `YT_TEST_DEVICE_CLIENT_ID`, and
+  `YT_TEST_DEVICE_CLIENT_SECRET` respectively).
+* Server application tests, which use a server API key
+  (`YT_TEST_SERVER_API_KEY`).
+* Tests that excercise YouTube's partner functionality. This requires an
+  a partner channel id (`YT_TEST_CONTENT_OWNER_NAME`), a refresh token
+  that's authenticated with that channel
+  (`YT_TEST_CONTENT_OWNER_REFRESH_TOKEN`), and the corresponding
+  application (`YT_TEST_PARTNER_CLIENT_ID` and
+  (`YT_TEST_PARTNER_CLIENT_SECRET`).
+
+The refresh tokens need to be generated with the `youtube`,
+`yt-analytics` and `userinfo.profile` permissions in order for tests to
+pass.
 
 How to release new versions
 ===========================
@@ -568,3 +591,4 @@ the [YouTube Analytics API](https://developers.google.com/youtube/analytics).
 If you find that a method is missing, fork the project, add the missing code,
 write the appropriate tests, then submit a pull request, and it will gladly
 be merged!
+

data/lib/yt/actions/get.rb

@@ -0,0 +1,33 @@
+require 'yt/request'
+
+module Yt
+  module Actions
+    module Get
+      include Base
+
+      def get
+        response = get_request(get_params).run
+        @data.merge! response.body
+        self
+      end
+
+    private
+
+      def get_request(params = {})
+        @list_request = Yt::Request.new(params).tap do |request|
+          print "#{request.as_curl}\n" if Yt.configuration.developing?
+        end
+      end
+
+      def get_params
+        {}.tap do |params|
+          params[:method] = :get
+          params[:host] = 'www.googleapis.com'
+          params[:auth] = @auth
+          params[:exptected_response] = Net::HTTPOK
+          params[:api_key] = Yt.configuration.api_key if Yt.configuration.api_key
+        end
+      end
+    end
+  end
+end

data/lib/yt/collections/claims.rb

@@ -11,6 +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]
+        body[:match_info] = match_attributes(attributes[:match_info]) if attributes[:match_info]
         params = attributes.slice(:is_manual_claim).merge({on_behalf_of_content_owner: @auth.owner_name})
         do_insert(params: params, body: body)
       end
@@ -38,6 +39,13 @@ module Yt
         super
       end
 
+      def match_attributes(attributes = {})
+        segments = attributes[:match_segments].map do |segment|
+          { manual_segment: (segment[:manual_segment] || segment).slice(:start, :finish) }
+        end
+        { matchSegments: segments }
+      end
+
       # @return [Hash] the parameters to submit to YouTube to list claims
       #   administered by the content owner.
       # @see https://developers.google.com/youtube/partner/docs/v1/claims/list

data/lib/yt/collections/content_owners.rb

@@ -25,8 +25,12 @@ module Yt
       end
 
       def content_owners_params
-        {fetch_mine: true}
+        if @where_params.blank?
+          {fetch_mine: true}
+        else
+          apply_where_params! on_behalf_of_content_owner: @parent.owner_name
+        end
       end
     end
   end
-end
+end

data/lib/yt/collections/snippets.rb

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

data/lib/yt/config.rb

@@ -0,0 +1,54 @@
+require 'yt/models/configuration'
+
+module Yt
+  # Provides methods to read and write global configuration settings.
+  #
+  # A typical usage is to set the API keys retrieved from the
+  # {http://console.developers.google.com Google Developers Console}.
+  #
+  # @example Set the API key for a server-only YouTube app:
+  #   Yt.configure do |config|
+  #     config.api_key = 'ABCDEFGHIJ1234567890'
+  #   end
+  #
+  # @example Set the API client id/secret for a web-client YouTube app:
+  #   Yt.configure do |config|
+  #     config.client_id = 'ABCDEFGHIJ1234567890'
+  #     config.client_secret = 'ABCDEFGHIJ1234567890'
+  #   end
+  #
+  # Note that Yt.configure has precedence over values through with
+  # environment variables (see {Yt::Models::Configuration}).
+  #
+  module Config
+    # Yields the global configuration to the given block.
+    #
+    # @example
+    #   Yt.configure do |config|
+    #     config.api_key = 'ABCDEFGHIJ1234567890'
+    #   end
+    #
+    # @yield [Yt::Models::Configuration] The global configuration.
+    def configure
+      yield configuration if block_given?
+    end
+
+    # Returns the global {Yt::Models::Configuration} object.
+    #
+    # While this method _can_ be used to read and write configuration settings,
+    # it is easier to use {Yt::Config#configure} Yt.configure}.
+    #
+    # @example
+    #     Yt.configuration.api_key = 'ABCDEFGHIJ1234567890'
+    #
+    # @return [Yt::Models::Configuration] The global configuration.
+    def configuration
+      @configuration ||= Yt::Configuration.new
+    end
+  end
+
+  # @note Config is the only module auto-loaded in the Yt module,
+  #       in order to have a syntax as easy as Yt.configure
+
+  extend Config
+end

data/lib/yt/models/asset.rb

@@ -12,6 +12,7 @@ module Yt
         @data = options.fetch(:data, {})
         @id = options[:id]
         @auth = options[:auth]
+        @params = options[:params]
       end
 
       def update(attributes = {})
@@ -34,6 +35,10 @@ module Yt
         @metadata_effective ||= Yt::Models::AssetMetadata.new data: @data.fetch('metadataEffective', {})
       end
 
+      def ownership_effective
+        @ownership_effective ||= Yt::Models::Ownership.new data: @data.fetch('ownershipEffective', {})
+      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
@@ -64,11 +69,11 @@ module Yt
       #   +'show'+, +'sound_recording'+, +'video_game'+, +'web'+.
       has_attribute :type
 
-      # @return [Array<Yt::Models::Tag>] the list of asset labels associated
+      # @return [Array<String>] 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
+      has_attribute :label, default: []
 
 # Status
 
@@ -106,6 +111,15 @@ module Yt
           params[:params] = {on_behalf_of_content_owner: @auth.owner_name}
         end
       end
+
+      # @return [Hash] the parameters to submit to YouTube to get an asset.
+      # @see https://developers.google.com/youtube/partner/docs/v1/assets/get
+      def get_params
+        super.tap do |params|
+          params[:path] = "/youtube/partner/v1/assets/#{@id}"
+          params[:params] = {on_behalf_of_content_owner: @auth.owner_name}.merge! @params
+        end
+      end
     end
   end
-end
+end

data/lib/yt/models/asset_metadata.rb

@@ -23,7 +23,7 @@ module Yt
       end
 
       # @return [String] A description of the asset. The description may be
-      #   displayed on YouTube or in CMS. 
+      #   displayed on YouTube or in CMS.
       def notes
         @data['notes']
       end

data/lib/yt/models/base.rb

@@ -1,6 +1,7 @@
 require 'yt/actions/delete'
 require 'yt/actions/update'
 require 'yt/actions/patch'
+require 'yt/actions/get'
 
 require 'yt/associations/has_attribute'
 require 'yt/associations/has_authentication'
@@ -17,6 +18,7 @@ module Yt
       include Actions::Delete
       include Actions::Update
       include Actions::Patch
+      include Actions::Get
 
       include Associations::HasAttribute
       extend Associations::HasReports

data/lib/yt/models/claim.rb

@@ -14,6 +14,17 @@ module Yt
         @asset = options[:asset] if options[:asset]
       end
 
+      # Updates the attributes of a claim.
+      # @note If you are submitting an update request, and your request does
+      #   not specify a value for a property that already has a value, the
+      #   property's existing value will be deleted.
+      # @return [Boolean] whether the claim was successfully updated.
+      def update(attributes = {})
+        underscore_keys! attributes
+        do_patch body: attributes
+        true
+      end
+
       # @!attribute [r] claim_history
       #   @return [Yt::Collections::ClaimHistories] the claim's history.
       has_one :claim_history

data/lib/yt/models/configuration.rb

@@ -0,0 +1,70 @@
+module Yt
+  module Models
+    # Provides an object to store global configuration settings.
+    #
+    # This class is typically not used directly, but by calling
+    # {Yt::Config#configure Yt.configure}, which creates and updates a single
+    # instance of {Yt::Models::Configuration}.
+    #
+    # @example Set the API client id/secret for a web-client YouTube app:
+    #   Yt.configure do |config|
+    #     config.client_id = 'ABCDEFGHIJ1234567890'
+    #     config.client_secret = 'ABCDEFGHIJ1234567890'
+    #   end
+    #
+    # @see Yt::Config for more examples.
+    #
+    # An alternative way to set global configuration settings is by storing
+    # them in the following environment variables:
+    #
+    # * +YT_CLIENT_ID+ to store the Client ID for web/device apps
+    # * +YT_CLIENT_SECRET+ to store the Client Secret for web/device apps
+    # * +YT_API_KEY+ to store the API key for server/browser apps
+    # * +YT_LOG_LEVEL+ to store the verbosity level of the logs
+    #
+    # In case both methods are used together,
+    # {Yt::Config#configure Yt.configure} takes precedence.
+    #
+    # @example Set the API client id/secret for a web-client YouTube app:
+    #   ENV['YT_CLIENT_ID'] = 'ABCDEFGHIJ1234567890'
+    #   ENV['YT_CLIENT_SECRET'] = 'ABCDEFGHIJ1234567890'
+    #
+    class Configuration
+      # @return [String] the Client ID for web/device YouTube applications.
+      # @see https://console.developers.google.com Google Developers Console
+      attr_accessor :client_id
+
+      # @return [String] the Client Secret for web/device YouTube applications.
+      # @see https://console.developers.google.com Google Developers Console
+      attr_accessor :client_secret
+
+      # @return [String] the API key for server/browser YouTube applications.
+      # @see https://console.developers.google.com Google Developers Console
+      attr_accessor :api_key
+
+      # @return [String] the level of output to print for debugging purposes.
+      attr_accessor :log_level
+
+      # Initialize the global configuration settings, using the values of
+      # the specified following environment variables by default.
+      def initialize
+        @client_id = ENV['YT_CLIENT_ID']
+        @client_secret = ENV['YT_CLIENT_SECRET']
+        @api_key = ENV['YT_API_KEY']
+        @log_level = ENV['YT_LOG_LEVEL']
+      end
+
+      # @return [Boolean] whether the logging output is extra-verbose.
+      #   Useful when developing (e.g., to print the curl of every request).
+      def developing?
+        log_level.to_s.in? %w(devel)
+      end
+
+      # @return [Boolean] whether the logging output is verbose.
+      #   Useful when debugging (e.g., to print the curl of failing requests).
+      def debugging?
+        log_level.to_s.in? %w(devel debug)
+      end
+    end
+  end
+end

data/lib/yt/models/content_owner.rb

@@ -46,6 +46,22 @@ module Yt
         @display_name = options[:display_name]
       end
 
+      # Uploads a reference file to YouTube.
+      # @param [String] path_or_url is the video or audio file to upload. Can either be the
+      #   path of a local file or the URL of a remote file.
+      # @param [Hash] params the metadata to add to the uploaded reference.
+      # @option params [String] :asset_id The id of the asset the uploaded reference belongs to.
+      # @option params [String] :content_type The type of content being uploaded.
+      # @return [Yt::Models::Reference] the newly uploaded reference.
+      def upload_reference_file(path_or_url, params = {})
+        file = open path_or_url, 'rb'
+        session = resumable_sessions.insert file.size, params
+
+        session.update(body: file) do |data|
+          Yt::Reference.new id: data['id'], data: data, auth: self
+        end
+      end
+
       def create_reference(params = {})
         references.insert params
       end
@@ -60,6 +76,12 @@ module Yt
 
     ### PRIVATE API ###
 
+      # @private
+      # Tells `has_many :resumable_sessions` what path to hit to upload a file.
+      def upload_path
+        '/upload/youtube/partner/v1/references'
+      end
+
       # @private
       # Tells `has_many :videos` that account.videos should return all the
       # videos *on behalf of* the content owner (public, private, unlisted).
@@ -67,6 +89,13 @@ module Yt
         {for_content_owner: true, on_behalf_of_content_owner: @owner_name}
       end
 
+      # @private
+      # Tells `has_many :resumable_sessions` what params are set for the object
+      # associated to the uploaded file.
+      def upload_params
+        {part: 'snippet,status', on_behalf_of_content_owner: self.owner_name}
+      end
+
       # @private
       # Tells `has_many :video_groups` that content_owner.video_groups should
       # return all the video-groups *on behalf of* the content owner

data/lib/yt/models/resource.rb

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

data/lib/yt/version.rb

@@ -1,3 +1,3 @@
 module Yt
-  VERSION = '0.32.3'
+  VERSION = '0.32.4'
 end

data/spec/collections/claims_spec.rb

@@ -3,11 +3,43 @@ require 'yt/collections/claims'
 require 'yt/models/content_owner'
 
 describe Yt::Collections::Claims do
-  subject(:collection) { Yt::Collections::Claims.new parent: content_owner }
   let(:content_owner) { Yt::ContentOwner.new owner_name: 'any-name' }
+  let(:collection) { Yt::Collections::Claims.new parent: content_owner, auth: content_owner }
   let(:page) { {items: [], token: 'any-token'} }
   let(:query) { {q: 'search string'} }
 
+  describe "#insert" do
+    let(:attributes) {
+      {
+        asset_id: 'some_asset_id',
+        video_id: 'some_video_id',
+        content_type: 'audiovisual',
+        policy: { id: 'some_policy_id' },
+        match_info: { match_segments: [ { manual_segment: { start: "00:01:00.000", finish: "00:02:00.000" } } ] },
+        is_manual_claim: true
+      }
+    }
+
+    before do
+      allow(collection).to receive(:do_insert)
+      collection.insert(attributes.deep_dup)
+    end
+
+    it 'calls do_insert with appropriate body' do
+      body = {
+        asset_id: 'some_asset_id',
+        video_id: 'some_video_id',
+        content_type: 'audiovisual',
+        policy: { id: 'some_policy_id' },
+        match_info: { matchSegments: [ { manual_segment: { start: "00:01:00.000", finish: "00:02:00.000" } } ] }
+      }
+      expect(collection).to have_received(:do_insert).with(
+        params: { is_manual_claim: true, on_behalf_of_content_owner: content_owner.owner_name },
+        body: body
+      )
+    end
+  end
+
   describe '#count' do
     context 'called once with .where(query) and once without' do
       after do
@@ -27,4 +59,4 @@ describe Yt::Collections::Claims do
       end
     end
   end
-end
+end

data/spec/models/asset_spec.rb

@@ -17,4 +17,16 @@ describe Yt::Asset do
       it { expect(asset.type).to eq 'web' }
     end
   end
-end
+
+  describe '#ownership_effective' do
+    context 'given fetching a asset returns an ownershipEffective' do
+      let(:data) {
+        {"ownershipEffective"=>{"kind"=>"youtubePartner#rightsOwnership",
+        "general"=>[{"ratio"=>100.0, "owner"=>"XOuN81q-MeEUVrsiZeK1lQ", "type"=>"exclude"}]}}
+      }
+      it { expect(asset.ownership_effective).to be_a Yt::Ownership }
+      it { expect(asset.ownership_effective.general_owners.first).to be_a Yt::RightOwner }
+      it { expect(asset.ownership_effective.general_owners.first.owner).to eq "XOuN81q-MeEUVrsiZeK1lQ" }
+    end
+  end
+end

data/spec/models/configuration_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe Yt::Configuration do
+  subject(:config) { Yt::Configuration.new }
+
+  describe '#client_id' do
+    context 'without an environment variable YT_CLIENT_ID' do
+      before { ENV['YT_CLIENT_ID'] = nil }
+      it {expect(config.client_id).to be_nil }
+    end
+
+    context 'given an environment variable YT_CLIENT_ID' do
+      let(:client_id) { '1234567890.apps.googleusercontent.com' }
+      before { ENV['YT_CLIENT_ID'] = client_id}
+      it {expect(config.client_id).to eq client_id }
+    end
+  end
+
+  describe '#client_secret' do
+    context 'without an environment variable YT_CLIENT_SECRET' do
+      before { ENV['YT_CLIENT_SECRET'] = nil }
+      it {expect(config.client_secret).to be_nil }
+    end
+
+    context 'given an environment variable YT_CLIENT_SECRET' do
+      let(:client_secret) { '1234567890' }
+      before { ENV['YT_CLIENT_SECRET'] = client_secret}
+      it {expect(config.client_secret).to eq client_secret }
+    end
+  end
+
+  describe '#api_key' do
+    context 'without an environment variable YT_API_KEY' do
+      before { ENV['YT_API_KEY'] = nil }
+      it {expect(config.api_key).to be_nil }
+    end
+
+    context 'given an environment variable YT_API_KEY' do
+      let(:api_key) { '123456789012345678901234567890' }
+      before { ENV['YT_API_KEY'] = api_key}
+      it {expect(config.api_key).to eq api_key }
+    end
+  end
+end

data/spec/requests/as_account/account_spec.rb

@@ -3,7 +3,7 @@ require 'spec_helper'
 require 'yt/models/account'
 
 describe Yt::Account, :device_app do
-  describe 'can create playlists' do
+  describe 'can create playlists', rate_limited: true do
     let(:params) { {title: 'Test Yt playlist', privacy_status: 'unlisted'} }
     before { @playlist = $account.create_playlist params }
     it { expect(@playlist).to be_a Yt::Playlist }
@@ -26,11 +26,6 @@ describe Yt::Account, :device_app do
       uploads = related_playlists.select{|p| p.title.starts_with? 'Uploads'}
       expect(uploads).not_to be_empty
     end
-
-    specify 'includes private playlists (such as History)' do
-      history = related_playlists.select{|p| p.title == 'History'}
-      expect(history).not_to be_empty
-    end
   end
 
   describe '.videos' do

data/spec/requests/as_account/channel_spec.rb

@@ -180,7 +180,7 @@ describe Yt::Channel, :device_app do
       expect(channel.subscriptions.size).to be
     end
 
-    describe 'playlists can be deleted' do
+    describe 'playlists can be deleted', rate_limited: true do
       let(:title) { "Yt Test Delete All Playlists #{rand}" }
       before { $account.create_playlist params }
 

data/spec/requests/as_account/playlist_item_spec.rb

@@ -5,7 +5,7 @@ describe Yt::PlaylistItem, :device_app do
   subject(:item) { Yt::PlaylistItem.new id: id, auth: $account }
 
   context 'given an existing playlist item' do
-    let(:id) { 'UExJQk5UR3NjRS1jalEwSllxWmoweElIX0RjaGRUT0tRSS41NkI0NEY2RDEwNTU3Q0M2' } # from my channel
+    let(:id) { 'UExiai1JRGU2Zzh2c0FQT0RFci1xRUZjRERvWHhqRzhEVC41MjE1MkI0OTQ2QzJGNzNG' }
 
     it 'returns valid metadata' do
       expect(item.title).to be_a String
@@ -28,7 +28,7 @@ describe Yt::PlaylistItem, :device_app do
     it { expect{item.snippet}.to raise_error Yt::Errors::RequestError }
   end
 
-  context 'given one of my own playlist items that I want to update' do
+  context 'given one of my own playlist items that I want to update', rate_limited: true do
     before(:all) do
       @my_playlist = $account.create_playlist title: "Yt Test Update Playlist Item #{rand}"
       @my_playlist.add_video '9bZkp7q19f0'

data/spec/requests/as_account/playlist_spec.rb

@@ -7,7 +7,7 @@ describe Yt::Playlist, :device_app do
   subject(:playlist) { Yt::Playlist.new id: id, auth: $account }
 
   context 'given an existing playlist' do
-    let(:id) { 'PLbsGxdAPhjv_bsJtQzUgD0SA-AReDCynL' } # from YouTube Creators
+    let(:id) { 'PLpjK416fmKwQlQ0KvTWFmXZZa3d4IO2ro' } # from YouTube Creators
 
     it 'returns valid metadata' do
       expect(playlist.title).to be_a String
@@ -56,7 +56,7 @@ describe Yt::Playlist, :device_app do
   end
 
   context 'given someone else’s playlist' do
-    let(:id) { 'PLbsGxdAPhjv_bsJtQzUgD0SA-AReDCynL' } # from YouTube Creators
+    let(:id) { 'PLpjK416fmKwQlQ0KvTWFmXZZa3d4IO2ro' } # from YouTube Creators
     let(:video_id) { '9bZkp7q19f0' }
 
     it { expect{playlist.delete}.to fail.with 'playlistForbidden' }
@@ -65,14 +65,14 @@ describe Yt::Playlist, :device_app do
     it { expect{playlist.delete_playlist_items}.to raise_error Yt::Errors::RequestError }
   end
 
-  context 'given one of my own playlists that I want to delete' do
+  context 'given one of my own playlists that I want to delete', rate_limited: true do
     before(:all) { @my_playlist = $account.create_playlist title: "Yt Test Delete Playlist #{rand}" }
     let(:id) { @my_playlist.id }
 
     it { expect(playlist.delete).to be true }
   end
 
-  context 'given one of my own playlists that I want to update' do
+  context 'given one of my own playlists that I want to update', rate_limited: true do
     before(:all) { @my_playlist = $account.create_playlist title: "Yt Test Update Playlist #{rand}" }
     after(:all) { @my_playlist.delete }
     let(:id) { @my_playlist.id }

data/spec/requests/as_account/video_spec.rb

@@ -276,7 +276,7 @@ describe Yt::Video, :device_app do
       end
     end
 
-    it 'returns valid reports for video-related metrics' do
+    it 'returns valid reports for video-related metrics', extended_permissions: true do
       # Some reports are only available to Content Owners.
       # See content owner test for more details about what the methods return.
       expect{video.views}.not_to raise_error
@@ -327,7 +327,7 @@ describe Yt::Video, :device_app do
     context 'passing the parameter in underscore syntax' do
       let(:attrs) { {publish_at: new_scheduled_at} }
 
-      specify 'only updates the timestamp to publish the video' do
+      specify 'only updates the timestamp to publish the video', flaky: true do
         expect(video.update attrs).to be true
         expect(video.privacy_status).to eq old_privacy_status
         expect(video.title).to eq old_title
@@ -369,13 +369,13 @@ describe Yt::Video, :device_app do
     let(:id) { $account.videos.where(order: 'viewCount').first.id }
     let(:update) { video.upload_thumbnail path_or_url }
 
-    context 'given the path to a local JPG image file' do
+    context 'given the path to a local JPG image file', extended_permissions: true do
       let(:path_or_url) { File.expand_path '../thumbnail.jpg', __FILE__ }
 
       it { expect{update}.not_to raise_error }
     end
 
-    context 'given the path to a remote PNG image file' do
+    context 'given the path to a remote PNG image file', extended_permissions: true do
       let(:path_or_url) { 'https://bit.ly/yt_thumbnail' }
 
       it { expect{update}.not_to raise_error }
@@ -396,7 +396,7 @@ describe Yt::Video, :device_app do
   # @see https://developers.google.com/youtube/v3/docs/videos#fileDetails
   # @see https://developers.google.com/youtube/v3/docs/videos#processingDetails.fileDetailsAvailability
   context 'given one of my own videos' do
-    let(:id) { 'nHz3FnAMH3U' }
+    let(:id) { $account.videos.first.id }
 
     it 'returns valid file details' do
       expect(video.file_name).to be_a String

data/spec/requests/as_content_owner/account_spec.rb

@@ -26,4 +26,4 @@ describe Yt::Account, :partner do
       end
     end
   end
-end
+end

data/spec/requests/as_content_owner/asset_spec.rb

@@ -4,16 +4,27 @@ require 'yt/models/content_owner'
 describe Yt::Asset, :partner do
   describe '.ownership' do
     let(:asset) { Yt::Asset.new id: asset_id, auth: $content_owner }
+
     describe 'given an asset administered by the content owner' do
       let(:asset_id) { ENV['YT_TEST_PARTNER_ASSET_ID'] }
 
-      specify 'the ownership can be obtained' do
-        expect(asset.ownership).to be_a Yt::Ownership
+      describe 'when performing an update' do
+        specify 'the ownership can be obtained' do
+          expect(asset.ownership).to be_a Yt::Ownership
+        end
+
+        describe 'the asset can be updated' do
+          let(:attrs) { {metadata_mine: {notes: 'Yt notes'}} }
+          it { expect(asset.update attrs).to be true }
+        end
       end
 
-      describe 'the asset can be updated' do
-        let(:attrs) { {metadata_mine: {notes: 'Yt notes'}} }
-        it { expect(asset.update attrs).to be true }
+      describe 'when performing a get' do
+        let(:asset_with_metadata_mine) { Yt::Asset.new id: asset_id, auth: $content_owner, params: {fetch_metadata: 'mine'} }
+
+        specify 'the metadata mine can be obtained' do
+          expect(asset_with_metadata_mine.get.metadata_mine.custom_id).to be_a String
+        end
       end
     end
   end

data/spec/requests/as_content_owner/claim_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+require 'yt/models/content_owner'
+
+describe Yt::Claim, :partner do
+  describe '.ownership' do
+    let(:claim) { Yt::Claim.new id: claim_id, auth: $content_owner }
+
+    describe 'given a claim administered by the content owner' do
+      let(:claim_id) { ENV['YT_TEST_PARTNER_CLAIM_ID'] }
+
+      describe 'the claim can be updated' do
+        let(:attrs) { {block_outside_ownership: true} }
+        it { expect(claim.update attrs).to be true }
+      end
+    end
+  end
+end

data/spec/requests/as_content_owner/content_owner_spec.rb

@@ -1,5 +1,6 @@
 require 'spec_helper'
 require 'yt/models/content_owner'
+require 'yt/models/match_policy'
 
 describe Yt::ContentOwner, :partner do
   describe '.partnered_channels' do
@@ -264,6 +265,26 @@ describe Yt::ContentOwner, :partner do
         it { expect(reference).not_to be }
       end
     end
+
+    describe '.upload_reference_file' do
+      let(:asset) { Yt::Asset.new id: ENV['YT_TEST_PARTNER_ASSET_ID'], auth: $content_owner }
+      let(:match_policy) { Yt::MatchPolicy.new asset_id: ENV['YT_TEST_PARTNER_ASSET_ID'], auth: $content_owner }
+
+      let(:upload_params) { {asset_id: asset.id, content_type: 'video'} }
+      let(:reference) { $content_owner.upload_reference_file path_or_url, upload_params }
+      after { reference.delete }
+
+      before do
+        asset.ownership.update(assetId: asset.id) && asset.ownership.obtain!
+        match_policy.update policy_id: ENV['YT_TEST_PARTNER_POLICY_ID']
+      end
+
+      context 'given the URL of a remote video file' do
+        let(:path_or_url) { ENV['YT_REMOTE_VIDEO_URL'] }
+
+        it { expect(reference).to be_a Yt::Reference }
+      end
+    end
   end
 
   describe '.policies' do
@@ -305,16 +326,6 @@ describe Yt::ContentOwner, :partner do
     end
   end
 
-  describe '.bulk_report_jobs' do
-    describe 'given the content owner has bulk report jobs' do
-      let(:job) { $content_owner.bulk_report_jobs.first }
-
-      it 'returns valid job' do
-        expect(job.id).to be_a String
-        expect(job.report_type_id).to be_a String
-      end
-    end
-  end
   # @note: The following test works, but YouTube API endpoint to mark
   #   an asset as 'invalid' (soft-delete) does not work, and apparently
   #   there is no way to update the status of a asset.
@@ -326,4 +337,34 @@ describe Yt::ContentOwner, :partner do
   #   after { @asset.delete } # This does not seem to work
   #   it { expect(@asset).to be_a Yt::Asset }
   # end
+
+  describe '.bulk_report_jobs' do
+    describe 'given the content owner has bulk report jobs' do
+      let(:job) { $content_owner.bulk_report_jobs.first }
+
+      it 'returns valid job' do
+        expect(job.id).to be_a String
+        expect(job.report_type_id).to be_a String
+      end
+    end
+  end
+
+  describe '.content_owners' do
+    describe '.where(id: content_owner_ids)' do
+      let(:content_owner_a) { $content_owner.content_owners.where(id: content_owner_ids).first }
+
+      context 'given valid content owner names' do
+        let(:content_owner_ids) { 'a8MUrfnFEzBX3uLQepd5mg,GIfKLveZoYetfSFgvG2VtQ' }
+
+        it 'returns valid content owner' do
+          expect(content_owner_a.display_name).to be_a String
+        end
+      end
+
+      context 'given an unknown content owner ID' do
+        let(:content_owner_ids) { '--not-a-valid-owner-id--' }
+        it { expect(content_owner_a).not_to be }
+      end
+    end
+  end
 end

data/spec/requests/as_server_app/channel_spec.rb

@@ -5,7 +5,7 @@ describe Yt::Channel, :server_app do
   subject(:channel) { Yt::Channel.new attrs }
 
   context 'given an existing channel ID' do
-    let(:attrs) { {id: 'UCxO1tY8h1AhOz0T4ENwmpow'} }
+    let(:attrs) { {id: 'UCAmh1DexLGcMtDlzMCIxo4w'} }
 
     it 'returns valid snippet data' do
       expect(channel.snippet).to be_a Yt::Snippet
@@ -29,7 +29,7 @@ describe Yt::Channel, :server_app do
     end
 
     context 'with a hidden list of subscriptions' do
-      let(:attrs) { {id: 'UCG0hw7n_v0sr8MXgb6oel6w'} }
+      let(:attrs) { {id: 'UCZDZGN_73I019o6UYD2-4bg'} }
       it { expect{channel.subscribed_channels.size}.to raise_error Yt::Errors::Forbidden }
     end
   end
@@ -51,4 +51,4 @@ describe Yt::Channel, :server_app do
       it { expect(channel.videos.size).to be_zero }
     end
   end
-end
+end

data/spec/requests/as_server_app/comment_thread_spec.rb

@@ -6,11 +6,11 @@ describe Yt::CommentThread, :server_app do
   subject(:comment_thread) { Yt::CommentThread.new attrs }
 
   context 'given an existing comment thread ID about a channel' do
-    let(:attrs) { {id: 'z13kdnf4pursxnwr404cc3oz4zb0hjwirkg0k'} }
+    let(:attrs) { {id: 'UgzzJVW75s5KrSaf0Ah4AaABAg'} }
 
     it { expect(comment_thread.video_id).to be_nil }
     it { expect(comment_thread.total_reply_count).to be_an Integer }
-    it { expect(comment_thread.can_reply?).to be false }
+    it { expect(comment_thread.can_reply?).to be true }
     it { expect(comment_thread).to be_public }
 
     it { expect(comment_thread.top_level_comment).to be_a Yt::Comment }

data/spec/requests/as_server_app/playlist_item_spec.rb

@@ -5,7 +5,7 @@ describe Yt::PlaylistItem, :server_app do
   subject(:item) { Yt::PlaylistItem.new id: id }
 
   context 'given an existing playlist item' do
-    let(:id) { 'UExTV1lrWXpPclBNVDlwSkc1U3Q1RzBXRGFsaFJ6R2tVNC4yQUE2Q0JEMTk4NTM3RTZC' }
+    let(:id) { 'UExiai1JRGU2Zzh2c0FQT0RFci1xRUZjRERvWHhqRzhEVC41MjE1MkI0OTQ2QzJGNzNG' }
 
     it 'returns valid snippet data' do
       expect(item.snippet).to be_a Yt::Snippet
@@ -27,4 +27,4 @@ describe Yt::PlaylistItem, :server_app do
 
     it { expect{item.snippet}.to raise_error Yt::Errors::RequestError }
   end
-end
+end

data/spec/requests/as_server_app/playlist_spec.rb

@@ -5,7 +5,7 @@ describe Yt::Playlist, :server_app do
   subject(:playlist) { Yt::Playlist.new attrs }
 
   context 'given an existing playlist ID' do
-    let(:attrs) { {id: 'PLSWYkYzOrPMT9pJG5St5G0WDalhRzGkU4'} }
+    let(:attrs) { {id: 'PLpjK416fmKwQ6Ene4GKRLICznoE1QFyt4'} }
 
     it 'returns valid snippet data' do
       expect(playlist.snippet).to be_a Yt::Snippet
@@ -30,4 +30,4 @@ describe Yt::Playlist, :server_app do
     it { expect{playlist.snippet}.to raise_error Yt::Errors::NoItems }
     it { expect{playlist.status}.to raise_error Yt::Errors::NoItems }
   end
-end
+end

data/yt.gemspec

@@ -22,7 +22,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency 'activesupport' # '3 (Ruby 1.9) or 4 (Ruby 2)'
-  spec.add_dependency 'yt-support', '>= 0.1'
 
   # For development / Code coverage / Documentation
   spec.add_development_dependency 'bundler' #, '~> 1.0'
@@ -30,4 +29,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake' #, '~> 10.0'
   spec.add_development_dependency 'yard' #, '~> 0.8.0'
   spec.add_development_dependency 'coveralls' #, '~> 0.7.0'
+  spec.add_development_dependency 'pry'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yt
 version: !ruby/object:Gem::Version
-  version: 0.32.3
+  version: 0.32.4
 platform: ruby
 authors:
 - Claudio Baccigalupo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-17 00:00:00.000000000 Z
+date: 2019-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -25,21 +25,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: yt-support
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
-  type: :runtime
+        version: '0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: coveralls
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: coveralls
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -133,6 +133,7 @@ files:
 - lib/yt/actions/base.rb
 - lib/yt/actions/delete.rb
 - lib/yt/actions/delete_all.rb
+- lib/yt/actions/get.rb
 - lib/yt/actions/insert.rb
 - lib/yt/actions/list.rb
 - lib/yt/actions/modify.rb
@@ -185,6 +186,7 @@ files:
 - lib/yt/collections/video_categories.rb
 - lib/yt/collections/video_groups.rb
 - lib/yt/collections/videos.rb
+- lib/yt/config.rb
 - lib/yt/constants/geography.rb
 - lib/yt/errors/forbidden.rb
 - lib/yt/errors/missing_auth.rb
@@ -208,6 +210,7 @@ files:
 - lib/yt/models/claim_history.rb
 - lib/yt/models/comment.rb
 - lib/yt/models/comment_thread.rb
+- lib/yt/models/configuration.rb
 - lib/yt/models/content_detail.rb
 - lib/yt/models/content_owner.rb
 - lib/yt/models/content_owner_detail.rb
@@ -268,6 +271,7 @@ files:
 - spec/models/claim_spec.rb
 - spec/models/comment_spec.rb
 - spec/models/comment_thread_spec.rb
+- spec/models/configuration_spec.rb
 - spec/models/content_detail_spec.rb
 - spec/models/content_owner_detail_spec.rb
 - spec/models/file_detail_spec.rb
@@ -305,6 +309,7 @@ files:
 - spec/requests/as_content_owner/bulk_report_job_spec.rb
 - spec/requests/as_content_owner/channel_spec.rb
 - spec/requests/as_content_owner/claim_history_spec.rb
+- spec/requests/as_content_owner/claim_spec.rb
 - spec/requests/as_content_owner/content_owner_spec.rb
 - spec/requests/as_content_owner/match_policy_spec.rb
 - spec/requests/as_content_owner/ownership_spec.rb
@@ -376,6 +381,7 @@ test_files:
 - spec/models/claim_spec.rb
 - spec/models/comment_spec.rb
 - spec/models/comment_thread_spec.rb
+- spec/models/configuration_spec.rb
 - spec/models/content_detail_spec.rb
 - spec/models/content_owner_detail_spec.rb
 - spec/models/file_detail_spec.rb
@@ -413,6 +419,7 @@ test_files:
 - spec/requests/as_content_owner/bulk_report_job_spec.rb
 - spec/requests/as_content_owner/channel_spec.rb
 - spec/requests/as_content_owner/claim_history_spec.rb
+- spec/requests/as_content_owner/claim_spec.rb
 - spec/requests/as_content_owner/content_owner_spec.rb
 - spec/requests/as_content_owner/match_policy_spec.rb
 - spec/requests/as_content_owner/ownership_spec.rb