gdata_plus¶ ↑
Source code | RDoc | Ruby Gem
Simple, easy to use GData API that supports OAuth, Ruby 1.8/1.9 and uses Typhoeus as an HTTP client.
Installation¶ ↑
gem install gdata_plus
Making requests¶ ↑
Start by getting the client from the authenticator (see Authentication below).
client = authenticator.client
Then make a request.
response = client.get("https://picasaweb.google.com/data/feed/api/user/default")
Then parse the response using your preferred XML library. I’ll use Nokogiri for this example.
feed = Nokogiri::XML(response.body) album_titles = feed.xpath("//xmlns:entry/xmlns:title/text()").collect {|i| "#{i}"}
If you need more control over the request, then you can create your own Typhoeus request and submit it to the client.
request = Typhoeus::Request.new(...) client.submit request
Authentication¶ ↑
OAuth and ClientLogin are supported. OAuth is preferred for web apps and ClientLogin is convenient for installed apps and command-line utilities.
OAuth¶ ↑
Before using OAuth, you will need to register your domain and get a consumer key and consumer secret from Google. See the OAuth example for getting started with OAuth.
Using an existing access token¶ ↑
If you already have an access token and access token secret, then you can construct an OAuth authenticator as follows:
GDataPlus::Authenticator::OAuth.new( :consumer_key => CONSUMER_KEY, :consumer_secret => CONSUMER_SECRET, :access_token => access_token, :access_secret => access_secret )
ClientLogin¶ ↑
See the ClientLogin example.
Serializing authenticators¶ ↑
Both the OAuth and ClientLogin authenticators can be serialized using a method like to_yaml.
Error handling¶ ↑
TODO
Ruby support¶ ↑
This project is tested against Ruby 1.8.7 and Ruby 1.9.2. There is an issue with international characters and OAuth that affects Ruby 1.8.7.
Contributions¶ ↑
This project is actively maintained. Please submit an issue if you find any bugs or want to request a new feature. Contributions are welcome. Please run the tests with Ruby 1.9.2 and 1.8.7 before submitting a pull request:
rake test
Copyright¶ ↑
Copyright © 2010 Brian Alexander. See LICENSE.txt for further details.