Setup

Type in 'Google Calendar' in the search box and click on
'Google Calendar API' in the results.

Click on the 'Enable' link at the top of the page.

In the sidebar on the left, select Credentials.

If you haven't done so already, create your 'OAuth client ID'
by clicking Create Credentials'. Note: you need to set your
'Product name show to users' on the OAuth consent screen before you
can create your client ID.

Select the 'Other' option and click create.

Take note of the Client ID and Client Secret as you'll need to add
it to your code later.

In the calendar list on the left, click the down-arrow button next to the
appropriate calendar, then select Calendar settings.

In the Calendar Address section, locate the Calendar ID listed next to the
XML, ICAL and HTML buttons.

Copy the Calendar ID.

Usage

require'rubygems'require'google_calendar'# Create an instance of the calendar.
cal=Google::Calendar.new(:client_id=>YOUR_CLIENT_ID,:client_secret=>YOUR_SECRET,:calendar=>YOUR_CALENDAR_ID,:redirect_url=>"urn:ietf:wg:oauth:2.0:oob"# this is what Google uses for 'applications'
)puts"Do you already have a refresh token? (y/n)"has_token=$stdin.gets.chompifhas_token.downcase!='y'# A user needs to approve access in order to work with their calendars.
puts"Visit the following web page in your browser and approve access."putscal.authorize_urlputs"\nCopy the code that Google returned and paste it here:"# Pass the ONE TIME USE access code here to login and get a refresh token that you can use for access from now on.
refresh_token=cal.login_with_auth_code($stdin.gets.chomp)puts"\nMake sure you SAVE YOUR REFRESH TOKEN so you don't have to prompt the user to approve access again."puts"your refresh token is:\n\t#{refresh_token}\n"puts"Press return to continue"$stdin.gets.chompelseputs"Enter your refresh token"refresh_token=$stdin.gets.chompcal.login_with_refresh_token(refresh_token)# Note: You can also pass your refresh_token to the constructor and it will login at that time.
endevent=cal.create_eventdo|e|e.title='A Cool Event'e.start_time=Time.nowe.end_time=Time.now+(60*60)# seconds * min
endputseventevent=cal.find_or_create_event_by_id(event.id)do|e|e.title='An Updated Cool Event'e.end_time=Time.now+(60*60*2)# seconds * min * hours
endputsevent# All events
putscal.events# Query events
putscal.find_events('your search string')

This sample code is located in readme_code.rb in the root folder.

Ruby Support

The current google_calendar gem supports Ruby 2.1 and higher – because of
the json gem dependency. We maintain support for Ruby 1.8.7, 1.9.3 and 2.0
on different branches.

Notes

This is not a complete implementation of the calendar api, it just includes
the features we needed to support our internal calendar integration. Feel
free to add additional features and we will happily integrate them.

Contributing to google_calendar

Check out the latest master to make sure the feature hasn't been
implemented or the bug hasn't been fixed yet

Check out the issue tracker to make sure someone already hasn't
requested it and/or contributed it

Fork the project

Start a feature/bugfix branch

Commit and push until you are happy with your contribution

Make sure to add tests for it. This is important so I don't break it in
a future version unintentionally.

Please try not to mess with the Rakefile, version, or history. If you want
to have your own version, or is otherwise necessary, that is fine, but
please isolate to its own commit so I can cherry-pick around it.

Running Tests

The first time you run raketest Rake will copy over
.env.test to .env for use by Dotenv. You can also use
.env.default as your own starting point, just remember to copy it
over to .env before running tests.

You can modify .env with your own credentials and don't worry
about accidentally committing to the repo as .env is in the
.gitignore.