Introducing YouTube-G

Posted by shane
on Monday, February 11

Walter Korman and I are proud to release youtube-g version 0.4.1.

youtube-g is a pure Ruby client for the YouTube GData API. It provides an easy way to access the latest YouTube video search results from your own programs. In comparison with the earlier Youtube search interfaces, this new API and library offers much-improved flexibility around executing complex search queries to obtain well-targeted video search results.

More detail on the underlying source Google-provided API is available at:

http://code.google.com/apis/youtube/overview.html

FEATURES

Aims to be in parity with Google’s YouTube GData API. Core functionality is currently present—work is in progress to fill in the rest.

USE

Create a client:

require 'youtube_g'
client = YouTubeG::Client.new

Basic queries:

client.videos_by(:query => "penguin")
client.videos_by(:tags => ['tiger', 'leopard'])
client.videos_by(:categories => [:news, :sports])
client.videos_by(:categories => [:news, :sports], :tags => ['soccer', 'football'])
client.videos_by(:user => 'liz')

Standard feeds:

client.videos_by(:most_viewed)
client.videos_by(:top_rated, :time => :today)

Advanced queries (with boolean operators OR (either), AND (include), NOT (exclude)):

client.videos_by(:categories => { :either => [:news, :sports], :exclude => [:comedy] }, :tags => { :include => ['football'], :exclude => ['soccer'] })

DOCUMENTATION

Rubyforge project: http://rubyforge.org/projects/youtube-g/

RDoc: http://youtube-g.rubyforge.org/

Google Group: http://groups.google.com/group/ruby-youtube-library?hl=en

INSTALL

  • sudo gem install youtube-g

Changes:

0.4.1 / 2008-02-11

  • Added 3GPP video format [shane]
  • Fixed tests [shane]

0.4.0 / 2007-12-18

  • Fixed API projection in search URL [Pete Higgins]
  • Fixed embeddable video searching [Pete Higgins]
  • Fixed video embeddable detection [Pete Higgins]
  • Fixed unique id hyphen detection [Pete Higgins, Chris Taggart]

0.3.0 / 2007-09-17

  • Initial public release

NOTES

Our previous library, youtube, has been deprecated. Please use youtube-g from now on.

Who can guess what the name youtube-g is in reference to? Hint: Like us, you probably used BBS’s before the days of the web, when wide adoption of TCP/IP was still a few years away.

Comments

Leave a response

  1. jonuts – February 11, 2008 @ 03:10 AM

    i’m getting 404d on the gem. is there anywhere else i can get it from?

  2. Peyton – February 11, 2008 @ 04:13 AM

    The system looks interesting. I’ll try this new system because I do love searching and watching video on YouTube. I’ll see if there’s something change into it.

  3. Viktor – February 11, 2008 @ 06:16 AM

    3gpp availability is the best function of this. Since all videos i take are mostly encoded from my mobile phone.

  4. shane – February 11, 2008 @ 12:16 PM

    jonuts- This gem took a while to propagate through the gem servers. It should work now.

  5. Max – March 08, 2008 @ 11:17 AM
    hi, where is the output? I’ve used:
    1. ruby test_client.rb
  6. shane – March 09, 2008 @ 05:50 PM

    Max- What do you mean by output? That command will just run that particular test.

  7. Max – March 10, 2008 @ 05:03 AM

    I want to ask the query at “youtube’s API” and have the answer ina file. i.e. If I ask:

    client.videos_by(:query => “penguin”)

    where is the list of video whit “penguin”? (this means output for me)

    tnx, Max