google_calendar 0.6.2 → 0.7.0

checksums.yaml

@@ -1,4 +1,7 @@
 ---
+SHA256:
+  metadata.gz: acefcd4148fb09fb9ae42a28e6e2ebe85507e3388cc9a83c9ae79ec36eaa9349
+  data.tar.gz: b4df360b6242f88fcbd9d85cf32200bd47561e3482a0fad413904fc421e6832c
 SHA512:
-  metadata.gz: 37b7d1c2914d9c4975ff8477a94a5c5ae18d5cb8dacf089bbadb1a16414984adc4b606a97a08f52b9baae9beb018344c6cf6616f65d1064d4c5499d7ddc494a9
-  data.tar.gz: be2f3af778d82be79cebfac47135c2441363eeeffeed43d7eab04a3935f192b287fcc79b9b55b3bd02ccb6beac58eaf33c75db9d2a947efe42aadf64e106a25b
+  metadata.gz: 7705625116e7cc2c86f74c88d22f714d210f6ba955eab9775520883ee9274b6d624e118cae0d1401775bc2b28b4d5ed2ee4842652afdd2eb5dc019b61e904e50
+  data.tar.gz: 99e7c4f88747a310a2cafebd561a521c432b10fe40b7ddc658d891297fe978ec15f9d4f6ffa01c0b379800983d11ffbda3474ace8aa40e2a2ba028459a08d64e

data/.env.test

@@ -3,4 +3,4 @@ CLIENT_SECRET='roBgdbfEmJwPgrgi2mRbbO-f'
 REFRESH_TOKEN='1/eiqBWx8aj-BsdhwvlzDMFOUN1IN_HyThvYTujyksO4c'
 CALENDAR_ID='klei8jnelo09nflqehnvfzipgs@group.calendar.google.com'
 ACCESS_TOKEN='ya29.hYjPO0uHt63uWr5qmQtMEReZEvILcdGlPCOHDy6quKPyEQaQQvqaVAlLAVASaRm_O0a7vkZ91T8xyQ'
-REDIRECT_URL='urn:ietf:wg:oauth:2.0:oob'
+REDIRECT_URL='https://mytesturl.com/'

data/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version:
+          - '3.2'
+          - '3.3'
+          - '3.4'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rake test

data/Gemfile

@@ -1,5 +1,4 @@
-source "http://rubygems.org"
+source "https://rubygems.org"
 
 # Using google_calendar to manage dependencies
-gemspec 
-gem "codeclimate-test-reporter", group: :test, require: nil
+gemspec

data/Gemfile.lock

@@ -1,78 +1,104 @@
 PATH
   remote: .
   specs:
-    google_calendar (0.6.1)
-      TimezoneParser (~> 0.2.0)
-      json (>= 1.8.3, < 2.1)
+    google_calendar (0.7.0)
+      TimezoneParser (>= 0.3, < 1.1)
+      addressable (> 2.7.0)
+      json (>= 1.8.3)
       signet (~> 0.7)
+      sorted_set (~> 1.0)
 
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
-    TimezoneParser (0.2.0)
+    TimezoneParser (1.0.0)
       insensitive_hash
+      sqlite3
       tzinfo
-    addressable (2.5.0)
-      public_suffix (~> 2.0, >= 2.0.2)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     ansi (1.5.0)
-    builder (3.2.3)
-    codeclimate-test-reporter (1.0.5)
-      simplecov
+    base64 (0.3.0)
+    builder (3.2.4)
+    concurrent-ruby (1.3.7)
     docile (1.1.5)
-    dotenv (2.2.0)
-    faraday (0.11.0)
-      multipart-post (>= 1.2, < 3)
+    dotenv (2.7.6)
+    erb (6.0.4)
+    faraday (2.14.3)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.4)
+      net-http (~> 0.5)
     insensitive_hash (0.3.3)
-    json (2.0.3)
-    jwt (1.5.6)
-    metaclass (0.0.4)
-    minitest (5.10.1)
-    minitest-reporters (1.1.14)
+    json (2.3.1)
+    jwt (3.2.0)
+      base64
+    logger (1.7.0)
+    mini_portile2 (2.8.9)
+    minitest (5.27.0)
+    minitest-reporters (1.4.2)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
-    mocha (1.2.1)
-      metaclass (~> 0.0.1)
-    multi_json (1.12.1)
-    multipart-post (2.0.0)
-    public_suffix (2.0.5)
-    rake (11.3.0)
-    rb-fsevent (0.9.8)
-    rdoc (4.3.0)
-    ruby-progressbar (1.8.1)
-    shoulda-context (1.2.2)
-    signet (0.7.3)
-      addressable (~> 2.3)
-      faraday (~> 0.9)
-      jwt (~> 1.5)
-      multi_json (~> 1.10)
-    simplecov (0.13.0)
-      docile (~> 1.1.0)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.0)
+    mocha (2.8.2)
+      ruby2_keywords (>= 0.0.5)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    rake (13.0.1)
+    rb-fsevent (0.10.4)
+    rbs (4.0.3)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    rbtree (0.4.7)
+    rdoc (8.0.0)
+      erb
+      prism (>= 1.6.0)
+      rbs (>= 4.0.0)
+      tsort
+    ruby-progressbar (1.10.1)
+    ruby2_keywords (0.0.5)
+    shoulda-context (2.0.0)
+    signet (0.22.0)
+      addressable (~> 2.8)
+      faraday (>= 0.17.5, < 3.a)
+      jwt (>= 1.5, < 4.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    sorted_set (1.1.0)
+      rbtree
+    sqlite3 (2.9.5)
+      mini_portile2 (~> 2.8.0)
     terminal-notifier-guard (1.7.0)
-    thread_safe (0.3.5)
-    tzinfo (1.2.2)
-      thread_safe (~> 0.1)
+    tsort (0.2.0)
+    tzinfo (2.0.2)
+      concurrent-ruby (~> 1.0)
+    uri (1.1.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   bundler (>= 1.2)
-  codeclimate-test-reporter
   dotenv (~> 2.1)
   google_calendar!
   minitest (~> 5.1)
-  minitest-reporters (~> 1.0)
-  mocha (~> 1.1)
-  rake (~> 11)
+  minitest-reporters (~> 1.2)
+  mocha (~> 2.0)
+  rake (>= 11)
   rb-fsevent (~> 0.9)
-  rdoc (~> 4.1)
-  shoulda-context (~> 1.2)
+  rdoc (> 6.3.1)
+  shoulda-context (~> 2.0)
+  simplecov (~> 0.22)
   terminal-notifier-guard (~> 1.6)
 
 BUNDLED WITH
-   1.14.4
+  4.0.3

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2010 Steve Zich
+Copyright (c) 2010 Northworld, LLC.
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -2,31 +2,36 @@
 
 A fast lightweight and minimalist wrapper around the {Google Calendar}[https://www.google.com/calendar/] api.
 
-{<img src="https://badge.fury.io/rb/google_calendar.svg" alt="Gem Version" />}[http://badge.fury.io/rb/google_calendar] {<img src="https://travis-ci.org/northworld/google_calendar.png?branch=master" alt="Build Status" />}[https://travis-ci.org/northworld/google_calendar] {<img src="https://gemnasium.com/northworld/google_calendar.png" alt="Dependency Status" />}[https://gemnasium.com/northworld/google_calendar] {<img src="https://codeclimate.com/github/northworld/google_calendar/badges/gpa.svg" />}[https://codeclimate.com/github/northworld/google_calendar] {<img src="https://codeclimate.com/github/northworld/google_calendar/badges/coverage.svg" />}[https://codeclimate.com/github/northworld/google_calendar]
+{<img src="https://badge.fury.io/rb/google_calendar.svg" alt="Gem Version" />}[http://badge.fury.io/rb/google_calendar] {<img src="https://github.com/northworld/google_calendar/actions/workflows/ci.yml/badge.svg" alt="Build Status" />}[https://github.com/northworld/google_calendar/actions/workflows/ci.yml]
 == Install
   [sudo] gem install 'google_calendar'
 
 == Setup
 
+<b>Important Changes: Google no longer supports the 'urn:ietf:wg:oauth:2.0:oob' out-of-band OAuth method.  You must setup your OAuth Credentials with a publically accessible URL where you can grab your code from the URL paramaters after approving the OAuth request.  If your product is a Web Application, you can automate this set up by pointing the redirect_url to the appropriate method of your application.</b>
+
 <b>Obtain a Client ID and Secret</b>
 
 1. Go to the {Google Developers Console}[https://console.developers.google.com/].
-1. Select a project, or create a new one.
-1. In the sidebar on the left, expand APIs & auth. Next, click APIs. In the list of APIs, make sure the status is ON for the Calendar API.
+1. Select a project, or create a new one (at the top of the page).
+1. In the sidebar on the left, select Library.
+1. Type in 'Google Calendar' in the search box and click on 'Google Calendar API' in the results.
+1. Click on the 'Enable' link at the top of the page.
 1. In the sidebar on the left, select Credentials.
-1. In either case, you end up on the Credentials page and can create your project's credentials from here.
-1. If you haven't done so already, create your OAuth 2.0 credentials by clicking Create new Client ID under the OAuth heading. Next, look for your application's client ID and client secret in the relevant table. You may also create and edit redirect URIs from this page.
-
-<em>Take note of the Client ID as you'll need to add it to your code later.</em>
+1. If you haven't done so already, create your 'OAuth client ID' by clicking 'Create Credentials -> OAuth client ID'.  Choose Web Application as the type.  
+1. You must also provide an "Authorized redirect URIs" which is a publically reachable URL where google will redirect to after the OAuth approval.  Google will append the paramater 'code=<your auth code>' to this URL during redirection which will include the necessary code to authenticate the usage of this application.
+1. <em>Take note of the Client ID and Client Secret as you'll need to add it to your code later.</em>
+1. In the sidebar on the left, select "OAuth consent screen".  You must setup your Application Name, and add "Test users" if this is for personal use (i.e. you are setting up links to at limited set of known users' calendars), or "Publish" your app if this is for public use.
 
 <b>Find your calendar ID</b>
 
 1. Visit {Google Calendar}[https://www.google.com/calendar/] in your web browser.
-1. In the calendar list on the left, click the down-arrow button next to the appropriate calendar, then select Calendar settings.
-1. In the Calendar Address section, locate the Calendar ID listed next to the XML, ICAL and HTML buttons.
+1. In the calendar list on the left, click the three vertical dots next to the appropriate calendar, then select 'Settings and sharing'.
+1. From the left toolbar, choose 'Integrate Calendar'.  
+1. In the Integrate Calendar section, locate the Calendar ID at the top of the section.
 1. Copy the Calendar ID.
 
-== Usage
+== Usage (readme_code.rb)
   require 'rubygems'
   require 'google_calendar'
 
@@ -34,7 +39,7 @@ A fast lightweight and minimalist wrapper around the {Google Calendar}[https://w
   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'
+                             :redirect_url  => YOUR_REDIRECT_URL # This must match a url you permitted in your OAuth setting
                              )
 
   puts "Do you already have a refresh token? (y/n)"
@@ -45,7 +50,7 @@ A fast lightweight and minimalist wrapper around the {Google Calendar}[https://w
     # 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."
     puts cal.authorize_url
-    puts "\nCopy the code that Google returned and paste it here:"
+    puts "\nCopy the code out of the paramters after Google redirects you to your provided redirect_url"
 
     # 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 )
@@ -89,7 +94,7 @@ A fast lightweight and minimalist wrapper around the {Google Calendar}[https://w
 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.
+The current google_calendar gem supports Ruby 3.2 and higher -- the +signet+ OAuth2 dependency requires it.  Older Ruby versions (1.8.7 through 2.7) are maintained 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.
@@ -111,9 +116,9 @@ 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 not worry about
+You can modify +.env+ with your own credentials and don't worry about
 accidentally committing to the repo as +.env+ is in the +.gitignore+.
 
 == Copyright
 
-Copyright (c) 2010-2014 Steve Zich. See LICENSE.txt for further details.
+Copyright (c) 2010-2022 Northworld, LLC. See LICENSE.txt for further details.

data/VERSION

@@ -1 +1 @@
-0.6.1
+0.7.0

data/google_calendar.gemspec

@@ -2,10 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = "google_calendar"
-  s.version = "0.6.2"
-  s.date = "2017-02-17"
+  s.version = "0.7.0"
+  s.date = "2026-07-07"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.required_ruby_version = ">= 3.2"
 
   s.authors = ["Steve Zich"]
   s.email = "steve.zich@gmail.com"
@@ -24,21 +25,23 @@ Gem::Specification.new do |s|
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
 
   s.require_paths = ["lib"]
-  s.rubygems_version = "2.6.10"
 
+  s.add_runtime_dependency(%q<addressable>, ["> 2.7.0"])
   s.add_runtime_dependency(%q<signet>, ["~> 0.7"])
-  s.add_runtime_dependency(%q<json>, [">= 1.8.3", "< 2.1"])
-  s.add_runtime_dependency(%q<TimezoneParser>, ["~> 0.2.0"])
+  s.add_runtime_dependency(%q<json>, [">= 1.8.3"])
+  s.add_runtime_dependency(%q<TimezoneParser>, ">= 0.3", "< 1.1")
+  s.add_runtime_dependency(%q<sorted_set>, ["~> 1.0"])
 
   s.add_development_dependency(%q<terminal-notifier-guard>, ["~> 1.6"])
   s.add_development_dependency(%q<rb-fsevent>, ["~> 0.9"])
   s.add_development_dependency(%q<minitest>, ["~> 5.1"])
-  s.add_development_dependency(%q<minitest-reporters>, ["~> 1.0"])
-  s.add_development_dependency(%q<shoulda-context>, ["~> 1.2"])
+  s.add_development_dependency(%q<minitest-reporters>, ["~> 1.2"])
+  s.add_development_dependency(%q<shoulda-context>, "~> 2.0")
   s.add_development_dependency(%q<bundler>, [">= 1.2"])
-  s.add_development_dependency(%q<mocha>, ["~> 1.1"])
-  s.add_development_dependency(%q<rake>, ["~> 11"])
-  s.add_development_dependency(%q<rdoc>, ["~> 4.1"])
+  s.add_development_dependency(%q<mocha>, ["~> 2.0"])
+  s.add_development_dependency(%q<rake>, [">= 11"])
+  s.add_development_dependency(%q<rdoc>, ["> 6.3.1"])
   s.add_development_dependency(%q<dotenv>, ["~> 2.1"])
+  s.add_development_dependency(%q<simplecov>, ["~> 0.22"])
 
 end

data/lib/google/calendar.rb

@@ -6,15 +6,15 @@ module Google
   #
   class Calendar
 
-    attr_reader :id, :connection, :summary
+    attr_reader :id, :connection, :summary, :location, :description, :time_zone
 
     #
     # Setup and connect to the specified Google Calendar.
     #  the +params+ paramater accepts
     # * :client_id => the client ID that you received from Google after registering your application with them (https://console.developers.google.com/). REQUIRED
     # * :client_secret => the client secret you received from Google after registering your application with them. REQUIRED
-    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. Use 'urn:ietf:wg:oauth:2.0:oob' if you are using an 'application'" REQUIRED
-    # * :calendar_id => the id of the calendar you would like to work with (see Readme.rdoc for instructions on how to find yours)
+    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. REQUIRED
+    # * :calendar => the id of the calendar you would like to work with (see Readme.rdoc for instructions on how to find yours). REQUIRED
     # * :refresh_token => if a user has already given you access to their calendars, you can specify their refresh token here and you will be 'logged on' automatically (i.e. they don't need to authorize access again). OPTIONAL
     #
     # See Readme.rdoc or readme_code.rb for an explication on the OAuth2 authorization process.
@@ -23,7 +23,7 @@ module Google
     # 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'
+    #                      :redirect_url => "http://myapplicationurl.com/"
     #                     )
     #
     def initialize(params={}, connection=nil)
@@ -36,8 +36,11 @@ module Google
     #  the +params+ paramater accepts
     # * :client_id => the client ID that you received from Google after registering your application with them (https://console.developers.google.com/). REQUIRED
     # * :client_secret => the client secret you received from Google after registering your application with them. REQUIRED
-    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. Use 'urn:ietf:wg:oauth:2.0:oob' if you are using an 'application'" REQUIRED
-    # * :summary => title of the calendar being created.
+    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. REQUIRED
+    # * :summary => title of the calendar being created. OPTIONAL
+    # * :location => geographic location of the calendar as free-form text. OPTIONAL
+    # * :time_zone => the time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. "Europe/Zurich".) OPTIONAL
+    # * :description => description of the calendar. OPTIONAL
     # * :refresh_token => if a user has already given you access to their calendars, you can specify their refresh token here and you will be 'logged on' automatically (i.e. they don't need to authorize access again). OPTIONAL
     #
     # See Readme.rdoc or readme_code.rb for an explication on the OAuth2 authorization process.
@@ -47,16 +50,98 @@ module Google
     #                         :client_id => YOUR_CLIENT_ID,
     #                         :client_secret => YOUR_SECRET,
     #                         :summary => 'Test Calendar',
-    #                         :redirect_url => "urn:ietf:wg:oauth:2.0:oob" # this is what Google uses for 'applications'
+    #                         :location => 'Somewhere',
+    #                         :description => 'Test Calendar Description',
+    #                         :time_zone => 'Europe/Zurich',
+    #                         :redirect_url => "http://myapplicationurl.com/"
     #                        )
     #
     def self.create(params={}, connection=nil)
       cal = new(params, connection)
       cal.instance_variable_set(:@summary, params[:summary])
+      cal.instance_variable_set(:@location, params[:location])
+      cal.instance_variable_set(:@description, params[:description])
+      cal.instance_variable_set(:@time_zone, params[:time_zone])
 
       cal.save
     end
 
+    #
+    # Connect and retrieve a Google Calendar.
+    #  the +params+ paramater accepts
+    # * :client_id => the client ID that you received from Google after registering your application with them (https://console.developers.google.com/). REQUIRED
+    # * :client_secret => the client secret you received from Google after registering your application with them. REQUIRED
+    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. REQUIRED
+    # * :calendar => the id of the calendar you would like to work with (see Readme.rdoc for instructions on how to find yours). REQUIRED
+    # * :refresh_token => if a user has already given you access to their calendars, you can specify their refresh token here and you will be 'logged on' automatically (i.e. they don't need to authorize access again). OPTIONAL
+    #
+    # See Readme.rdoc or readme_code.rb for an explication on the OAuth2 authorization process.
+    #
+    # ==== Example
+    # Google::Calendar.get(
+    #                      :client_id => YOUR_CLIENT_ID,
+    #                      :client_secret => YOUR_SECRET,
+    #                      :calendar => YOUR_CALENDAR_ID,
+    #                      :redirect_url => "http://myapplicationurl.com/"
+    #                     )
+    #
+    def self.get(params={}, connection=nil)
+      cal = new(params, connection)
+      cal.retrieve_calendar
+    end
+
+    #
+    # Connect and update a Google Calendar.
+    #  the +params+ paramater accepts
+    # * :summary => title of the calendar being created. OPTIONAL
+    # * :location => geographic location of the calendar as free-form text. OPTIONAL
+    # * :time_zone => the time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. "Europe/Zurich".) OPTIONAL
+    # * :description => description of the calendar. OPTIONAL
+    # * :refresh_token => if a user has already given you access to their calendars, you can specify their refresh token here and you will be 'logged on' automatically (i.e. they don't need to authorize access again). OPTIONAL
+    #
+    # See Readme.rdoc or readme_code.rb for an explication on the OAuth2 authorization process.
+    #
+    # ==== Example
+    # google_calendar_object.update(
+    #                               :summary => 'Test Calendar',
+    #                               :location => 'Somewhere',
+    #                               :description => 'Test Calendar Description',
+    #                               :time_zone => 'Europe/Zurich',
+    #                              )
+    #
+    def update(params={})
+      instance_variable_set(:@summary, params[:summary])
+      instance_variable_set(:@location, params[:location])
+      instance_variable_set(:@description, params[:description])
+      instance_variable_set(:@time_zone, params[:time_zone])
+
+      response =
+        send_calendar_request(
+                              "/#{@id}", 
+                              :put, 
+                              {
+                               summary: @summary,
+                               location: @location,
+                               description: @description,
+                               timeZone: @time_zone,
+                              }.to_json
+                             )
+      @raw = JSON.parse(response.body)
+      self
+    end
+
+    #
+    # Destroy a Google Calendar.
+    #
+    # See Readme.rdoc or readme_code.rb for an explication on the OAuth2 authorization process.
+    #
+    # ==== Example
+    # google_calendar_object.destroy
+    #
+    def destroy
+      send_calendar_request("/#{@id}", :delete)
+    end
+
     #
     # The URL you need to send a user in order to let them grant you access to their calendars.
     #
@@ -105,10 +190,27 @@ module Google
     #   the calendar that was saved.
     #
     def save
-      response = send_calendar_request("/", :post, {:summary => @summary}.to_json)
+      response = send_calendar_request("/", :post, {:summary => @summary}.to_json)     
       update_after_save(response)
     end
 
+    #
+    # Get an existing calender.
+    #  Returns:
+    #   the calendar that was requested.
+    #
+    def retrieve_calendar
+      response = send_calendar_request("/#{@id}", :get)
+      @raw = JSON.parse(response.body)
+      instance_variable_set(:@summary, @raw['summary'])
+      instance_variable_set(:@location, @raw['location'])
+      instance_variable_set(:@description, @raw['description'])
+      instance_variable_set(:@time_zone, @raw['timeZone'])
+      @html_link = @raw['htmlLink']
+
+      self
+    end
+
     #
     # Find all of the events associated with this calendar.
     #  Returns:
@@ -269,8 +371,10 @@ module Google
     # If the event is no longer on the server it creates a new one with the specified values.
     # Works like the create_event method.
     #
-    def find_or_create_event_by_id(id, &blk)
-      if id && event = find_event_by_id(id)[0]
+    def find_or_create_event_by_id(id, &blk)      
+      event = id ? find_event_by_id(id)[0] : nil
+
+      if event
         setup_event(event, &blk)
       elsif id
         event = Event.new(id: id, new_event_with_id_specified: true)
@@ -290,12 +394,12 @@ module Google
       body = event.use_quickadd? ? nil : event.to_json
       notifications = "sendNotifications=#{event.send_notifications?}"
       query_string =  if event.use_quickadd?
-        "/quickAdd?#{notifications}&text=#{event.title}"
-      elsif event.new_event?
-        "?#{notifications}"
-      else # update existing event.
-        "/#{event.id}?#{notifications}"
-      end
+                        "/quickAdd?#{notifications}&text=#{event.title}"
+                      elsif event.new_event?
+                        "?#{notifications}"
+                      else # update existing event.
+                        "/#{event.id}?#{notifications}"
+                      end
 
       send_events_request(query_string, method, body)
     end

data/lib/google/calendar_list.rb

@@ -13,7 +13,7 @@ module Google
     # The +params+ parameter accepts
     # * :client_id => the client ID that you received from Google after registering your application with them (https://console.developers.google.com/). REQUIRED
     # * :client_secret => the client secret you received from Google after registering your application with them. REQUIRED
-    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. Use 'urn:ietf:wg:oauth:2.0:oob' if you are using an 'application'" REQUIRED
+    # * :redirect_url => the url where your users will be redirected to after they have successfully permitted access to their calendars. REQUIRED
     # * :refresh_token => if a user has already given you access to their calendars, you can specify their refresh token here and you will be 'logged on' automatically (i.e. they don't need to authorize access again). OPTIONAL
     #
     # See Readme.rdoc or readme_code.rb for an explication on the OAuth2 authorization process.

data/lib/google/connection.rb

@@ -9,12 +9,13 @@ module Google
     BASE_URI = "https://www.googleapis.com/calendar/v3"
     TOKEN_URI ="https://accounts.google.com/o/oauth2/token"
     AUTH_URI = "https://accounts.google.com/o/oauth2/auth"
-    SCOPE = "https://www.googleapis.com/auth/calendar"
+    DEFAULT_SCOPE = "https://www.googleapis.com/auth/calendar"
+
     attr_accessor :client
 
     def self.new_with_service_account(params)
       client = Signet::OAuth2::Client.new(
-        :scope => SCOPE,
+        :scope => params.fetch(:scope, DEFAULT_SCOPE),
         :issuer => params[:client_id],
         :audience => TOKEN_URI,
         :token_credential_uri => TOKEN_URI,
@@ -43,8 +44,9 @@ module Google
     #  the +params+ paramater accepts
     # * :client_id => the client ID that you received from Google after registering your application with them (https://console.developers.google.com/)
     # * :client_secret => the client secret you received from Google after registering your application with them.
-    # * :redirect_uri => the url where your users will be redirected to after they have successfully permitted access to their calendars. Use 'urn:ietf:wg:oauth:2.0:oob' if you are using an 'application'"
+    # * :redirect_uri => the url where your users will be redirected to after they have successfully permitted access to their calendars."
     # * :refresh_token => if a user has already given you access to their calendars, you can specify their refresh token here and you will be 'logged on' automatically (i.e. they don't need to authorize access again)
+    # * :scope => Optional. The scope of the access request, expressed either as an Array or as a space-delimited String.
     #
     def initialize(params, client=nil)
 
@@ -58,7 +60,7 @@ module Google
         :state => params[:state],
         :authorization_uri => AUTH_URI,
         :token_credential_uri => TOKEN_URI,
-        :scope => SCOPE
+        :scope => params.fetch(:scope, DEFAULT_SCOPE)
       )
 
       # try to get an access token if possible.
@@ -153,15 +155,33 @@ module Google
 
     #
     # Check for common HTTP Errors and raise the appropriate response.
+    # Note: error 401 (InvalidCredentialsError) is handled by Signet.
     #
     def check_for_errors(response) #:nodoc
       case response.status
         when 400 then raise HTTPRequestFailed, response.body
+        when 403 then parse_403_error(response)
         when 404 then raise HTTPNotFound, response.body
+        when 409 then raise RequestedIdentifierAlreadyExistsError, response.body
+        when 410 then raise GoneError, response.body
+        when 412 then raise PreconditionFailedError, response.body
+        when 500 then raise BackendError, response.body
       end
     end
 
-    private
+    #
+    # Utility method to centralize handling of 403 errors.
+    #
+    def parse_403_error(response)
+      case JSON.parse(response.body)["error"]["message"]
+        when "Forbidden"                        then raise ForbiddenError, response.body
+        when "Daily Limit Exceeded"             then raise DailyLimitExceededError, response.body
+        when "User Rate Limit Exceeded"         then raise UserRateLimitExceededError, response.body
+        when "Rate Limit Exceeded"              then raise RateLimitExceededError, response.body
+        when "Calendar usage limits exceeded."  then raise CalendarUsageLimitExceededError, response.body
+        else                                    raise ForbiddenError, response.body
+      end
+    end
 
     #
     # Utility method to centralize credential validation.