Skip to main content
Kinetic Community

Google Apps Calendar Share

This handler shares a Google Calendar.

Downloads

By downloading this file, you acknowledge that you agree to our Terms of Service

google_apps_calendar_share_v1.zip

This handler requires that you are running at least Kinetic Task 2.0.

Detailed Description

google_calendar_share.pngThis handler uses the Google API library to share a Google Calendar either publicly or privately. The handler first uses the inputted refresh token and client id/secret to authorize the client (instructions on how to get these values can be found below). A call is then made to exchange the Calendar Name for a unique Calendar Id. After retrieving that, another call is made to Google to complete the sharing of the calendar. A list of possible calendar access types can be found below. Any errors that occur during the posting process will be caught and re-raised by this handler.

* In order to use this handler, the account specified by the task info values needs to enable Calendar API in admin account.

 

 

Possible Calendar Access Parameter Values

Value Description
none Provide no access
freeBusyReader Provides read access to free/busy information
reader Provides read access to the calendar. Private events appear with details hidden
writer Provides read and write access to the calendar. Private events appear with details available
owner Provides ownership access to the calendar

 

 

Note: To use this API, you will need to input a Client Id/Secret and a Refresh Token as info values. Instructions on how to do this are below.

  To enable the Calendar API and get Client Id and Client Secret:
      1. Navigate to the 'Google Developers Console'
      2. Click on the Create Project button (or if you have an existing
         project that you wish to keep using, click on the project name.)
      3. Go to the APIs page and turn on the Calendar service
      4. Go to the Credientials page and Create a new Client Id
          * Select 'Installed Application' for the application type
          * Select 'Other' for the Installed Application Type

  To retrieve the Refresh Token for the account you want to post to
      1. Put this url into your browser, while substiuting [:client_id] for
         the client id of your application
      * https://accounts.google.com/o/oauth2/auth?client_id=[:client_id]&redirect_uri=urn:ietf:wg:oauth:2.0:oob&scope=https://www.googleapis.com/auth/calendar&response_type=code&access_type=offline

      2. Choose or add the account that you wish to connect the handler with
      3. Click accept to give your application permission to modify the calendar
      4. Copy and paste the success code that appears on the page
      5. Send a post request to get the refresh token
          * This can either done with Curl or with a browser extension like
            Advanced REST Client in Chrome (A sample curl call is below)

            POST URL = https://accounts.google.com/o/oauth2/token
            POST Parameters: code=[:code]&client_id=[:client_id]&client_secret=[:client_secret]&redirect_uri=urn:ietf:wg:oauth:2.0:oob&grant_type=authorization_code

            Sample Curl Call:
              curl -- data "code=[:code]&client_id=[:client_id]&client_secret=[:client_secret]&redirect_uri=urn:ietf:wg:oauth:2.0:oob&grant_type=authorization_code" https://accounts.google.com/o/oauth2/token

Parameters

Name Description
Calendar Name The name of the calendar that will be shared.
Sharing Scope The scope for who the calendar will be shared with. The scope will default to public access, but you can also limit it to user, group, or domain.
Recipient If the scope is not public, the username, group name or domain name for who the calendar will be shared with.
Calendar Access The access type that the recipient will have to the calendar.

Sample Configuration

Parameter Example Configuration
Calendar Name Example Calendar
Sharing Scope user
Recipient test.user@acme.com
Calendar Access owner

Results

This handlers returns no results.

Change Log

Version Date Description
1 2014-06-10 Initial Version