Skip to content


Subversion checkout URL

You can clone with
Download ZIP
No longer maintained - Please see
Latest commit d026894 @mgornick Update README
Failed to load latest commit information.
lib fixed auth_header def name from a typo
CHANGELOG changed readme and changelog to reflect need for this branch
gcal4ruby-0.3.1.gemspec modified gemspec to reflect updates to the branch


* Not maintained
Use at your own risk for example code or usage.

GCal4Ruby is a full featured wrapper for the google calendar API.  GCal4Ruby implements
all of the functionality available through the Google Calnedar API, including permissions,
attendees, reminders and event recurrence.  

==Author and Contact Information
This branch was made by Matt Gornick ( to implement Google AuthSub into the original 
GCal4Ruby that was created and is maintained by {Mike Reich}[] 
and is licenses under the GPL v2.  Feel free to use and update, but be sure to contribute your
code back to the project and attribute as required by the license.

===Example Application

GCal4Ruby has three major components: the service, calendar and event objects.  Each service
has many calendars, which in turn have many events.  Each service is the representation of a
google account, and thus must be successfully authenticated using valid Google Calendar
account credentials.  

Below are some common usage examples.  For more examples, check the documentation.
1. Authenticate
    service =
    service.authenticate("", "password")

2. Authenticate with Google AuthSub
		# your authentication controller (example is index action in the home controller):
			scope = ''
	    next_url = ''
	    secure = false  # set secure = true for signed AuthSub requests
	    session = true
	    @authsub_link = GData::Auth::AuthSub.get_url(next_url, scope, secure, session)

		# in your next_url controller as defined by your AuthSub link (in example would be the authenticated action)
			@token = params[:token]
  		client =
  		client.authsub_token = params[:token] # extract the single-use token from the URL query params
  		session[:token] = client.auth_handler.upgrade()
  		client.authsub_token = session[:token] if session[:token]
  		service.authsub_authenticate(session[:token], "")

3. Get Calendar List
    calendars = service.calendars

All usages assume a successfully authenticated Service.
1. Create a new Calendar
    cal =

2. Find an existing Calendar
    cal = Calendar.find(service, "New Calendar", :first)

3. Find all calendars containing the search term
    cal = Calendar.find(service, "Soccer Team")

4. Find a calendar by ID
    cal = Calendar.find(service, id, :first)
All usages assume a successfully authenticated Service and valid Calendar.
1. Create a new Event
    event =
    event.title = "Soccer Game"
    event.start = Time.parse("12-06-2009 at 12:30 PM")
    event.end = Time.parse("12-06-2009 at 1:30 PM")
    event.where = "Merry Playfields"

2. Find an existing Event
    event = Event.find(cal, "Soccer Game", {:scope => :first})

3. Find all events containing the search term
    event = Event.find(cal, "Soccer Game")

4. Create a recurring event for every saturday
    event =
    event.title = "Baseball Game"
    event.where = "Municipal Stadium"
    event.recurrence =
    event.recurrence.start = Time.parse("13-06-2009 at 4:30 PM")
    event.recurrence.end = Time.parse("13-06-2009 at 6:30 PM")
    event.recurrence.frequency = {"weekly" => ["SA"]} 

5. Create an event with a 15 minute email reminder
    event =
    event.title = "Dinner with Kate"
    event.start = Time.parse("20-06-2009 at 5 pm")
    event.end = Time.parse("20-06-209 at 8 pm")
    event.where = "Luigi's"
    event.reminder = {:minutes => 15, :method => 'email'}

6. Create an event with attendees
    event =
    event.title = "Dinner with Kate"
    event.start = Time.parse("20-06-2009 at 5 pm")
    event.end = Time.parse("20-06-209 at 8 pm")
    event.attendees => {:name => "Kate", :email => ""}
Something went wrong with that request. Please try again.