Google Calendar

Supported version: Cloud.

API Rate Limit: 60 requests per minute

Supported Authentication: OAuth 2.0 Authentication

Application Registration on Google

This document explains the steps to register the application and how to use it on Gathr.

Step 1: Register application on Google API Console.

Important: It will require additional permissions from the Google Cloud Administrator or from IT department to register an application.

Create Project

  1. Login to the following URL: Refer

  2. Click on Create Project and enter:

i. Project name: Any user friendly project name, for ex: Gathr

ii. Select Location/Organization

  1. Click on Create.

It will create the Project in your Google Console.

  1. Click on “Configure Consent Screen” appearing on your screen or click on “OAuth consent screen” from the left panel.

  2. Select External from User Type and click on Create.

  3. Enter a user friendly App name, for example: Gathr.

  4. Select your email as user support email.

  5. Provide a useful logo to App logo or/else you can skip App logo and App domain section.

  6. Scroll Down to Authorized domains and click on Add Domain. You can add as many authorized domains according to your organization from where requests might come to your Google App. For ex. gmail.com, gathr.one etc.

  7. Enter the require Email Address in Developer contact information and click on Save and Continue.

  8. Scroll Down and click on Save and Continue for “Scopes” and “Test users” form.

  9. Scroll Down and click on Back to Dashboard.

  10. Validate all the details and Click on “Publish App” and confirm it for Production Usage.

Create OAuth Credentials

  1. Click on ‘Credentials’ from left panel.

  2. Click on ‘Create Credentials’

  3. Choose ‘OAuth Client ID’

  4. On ‘Create OAuth client ID’

    a. Enter Application type: Web Application

    b. Enter Name: Gathr (or any suitable application name)

    c. Authorized redirect URIs : Redirect URL of Gathr host. Ex.: https://HostName123.gathr.one:48444/AccountManagementWebService/callback.html

Note that the “HostName-123.gathr.one” will be your organization’s HostName.domainName for the server where Gathr is deployed. Please replace this part with your Gathr Server’s HostName.domainName in the URL given above and then use it.

IMPORTANT: This URL should be accessible from the client machine from which end-user will access Gathr. You may need to create a DNS entry or configure proxy accordingly to make this URL accessible.

  1. Copy Client ID and Client Secret and keep it safe. We will need this information while configuring the connector on Gathr.

  2. Please enable Google Calendar, Refer

Step 2: Install Google Calendar Connector on Gathr.

  1. Login into Gathr and go to Store (Top Right of your screen) Section.

  2. Search for Google Calendar in the search box.

  3. Scroll down to Connectors section and click on three dots to install the connector.

  4. Once the connector is installed successfully, Click on Home or Apps Section on your screen.

  5. Click on the “Connectors" tab and check for “Google Calendar”.

  6. Double click on “Google Calendar” and click on Add Connection.

  7. Click on Advanced (bottom right of the popup) and:

Validate the following details in the form:

a. Instance URL: https://www.googleapis.com

b. Enter Application Key: Client ID received from Step 1 Create OAuth Cred section above.

c. Enter Application Secret: Client Secret received from Step 1 Create OAuth Cred section above..

d. Authorization URL: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent

e. Access Token URL: https://oauth2.googleapis.com/token

f. Domain for Callback Authentication: Validate HostName with Domain Name used in Step 1 Create OAuth Cred section above. Example: HostName-123.gathr.one

g. Scope: openid profile email https://www.googleapis.com/auth/drive.file & https://www.googleapis.com/auth/drive

h. Click on ‘Save’.

i. On clicking ‘Save’, a pop-up will appear which requires Google user to login using the credentials and choose ‘Allow access’ if asked in the pop-up window.

Important: Please make sure, the pop-up is not blocked by the chrome browser.

  1. Once it will be completed, it will ask for the URLs related to Google Calendar Connection:

    Validate the following details in the form:

    a. Instance URL: https://www.googleapis.com/drive/v3

    b. Application Key: Client ID received from Step 1 Create OAuth Credential section above.

    c. Application Secret: Client Secret received from Step 1 Create OAuth Credential section above.

    d. Authorization URL: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent

    e. Access Token URL: https://oauth2.googleapis.com/token

    f. Domain for Callback Authentication: Validate HostName with Domain Name used in Step 1 Create OAuth Cred section above. Example: HostName-123.gathr.one

    g. Scope:

    https://www.googleapis.com/auth/calendar.readonly

    https://www.googleapis.com/auth/calendar

    https://www.googleapis.com/auth/calendar.events.readonly

    https://www.googleapis.com/auth/calendar.events

    h. Click on ‘Save’.

    i. On clicking ‘Save’, a pop-up will appear which requires Google user to login using the credentials and choose ‘Allow access’ if asked in the pop-up window.

Important: Please make sure, the pop-up is not blocked by the chrome browser.

Step 3: Use Google Calendar Connector

To start the analysis, go to an editable app and right-click on the Floor -> Connectors-> All Connectors -> Google Calendar -> List Calendars

If you have any feedback on Gathr documentation, please email us!

← Google Analytics
Google Cloud BigQuery →