Project

yt_meta

0.0
No commit activity in last 3 years
No release in over 3 years
A tiny gem that pulls metadata for a specified video from Google's Youtube API
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
~> 2.14.1
~> 2.6.0
~> 1.13.0
 Project Readme

YtMeta

This gem takes a Youtube URL or ID and optional data attributes and returns a hash of metadata about the video.

Installation

Add this line to your application's Gemfile:

gem 'yt_meta'

And then execute:

$ bundle

Or install it yourself as:

$ gem install yt_meta

Usage

Google requires an API key to use the Youtube API. Follow these instructions to create an app: Generate Key. Use the server key Google generates for you as your API key. Then create an initializer with your API key and an optional default parts array so you don't have to specify the parts you want every time.

YtMeta.configure do |config|
  config.api_key = "API_KEY"
  config.parts = %w[snippet player] #optional
end

To retrieve all public data about a video (or your default parts), require "yt_meta" and then call YtMeta.fetch_data(youtube_id: "some_id").

If you wish to fetch only specific parts, call YtMeta.fetch_data(youtube_id: "some_id", parts: ["snippet", "player"]), replacing the parts in the array with the ones you want.

You can find a full list of available parts here: API Docs. Be aware that fileDetails, processingDetails, and suggestions require client OAuth2 login and won't work with this gem.

Contributing

  1. Fork!

  2. Create your feature branch (git checkout -b my-new-feature)

  3. Add a configuration file with your API key at spec/support/api_config.rb. It's .gitignored, so your credentials won't be saved to the repo.

    YtMeta.configure do |config|
      config.api_key = "TEST_API_KEY"
    end
  4. Make your changes!

  5. Make sure all tests pass! If you get SSL certificate verification errors when running the specs, try these fixes

  6. Commit your changes (git commit -am 'Add some feature')

  7. Push to the branch (git push origin my-new-feature)

  8. Create new Pull Request