googl-api

A very simple Ruby wrapper for the Google Url Shortener.

INSTALLATION:

gem install googl-api

USAGE:

Create a googl client using your API key and/or with ClientLogin auth information. (note: you will need to “Activate” the “URL Shortener API” on this page to retrieve and user your api_key: code.google.com/apis/console/b/0/#project:1090911256926:overview )

googl = GooglApi.new(:api_key => 'your_api_key', :email => 'google_email', :password => 'valid_password')

Then use the client to shorten, extend or review the analytics for a URL. If authentication is provided the short_url provided will be specific to the given user and will show up in the users history.

googl.shorten('http://www.google.com')
googl.expand('http://goo.gl/fbsS')
googl.analytics('http://goo.gl/fbsS') or googl.analytics('http://goo.gl/fbsS', 'FULL')

These methods will return a response object containing the short/long url and other values provide by the API

To access a users history you must provide authentication information

googl = GooglApi.new(:email => 'google_email', :password => 'valid_password')
googl.history

This method returns a hash containing the authenticated users history

ACKNOWLEDGEMENTS

Code heavily inspired/influenced by philnash's bitly gem github.com/philnash/bitly

Contributing to googl-api

Copyright © 2011 John Allen. See LICENSE.txt for further details.