Google Sheets

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 Analytics.

Step 1: Register application on Google API Console.

1. Login to the following URL: Refer

IMPORTANT:

• You will need additional permissions from the Google Cloud Administrator or from IT department to register an application. Please enable Google Drive & Google Sheets API, refer

• Please make sure your Google Sheets instance must be accessible from the Gathr Analytics Machine.

2. Go-to ‘Credentials’

3. Click on ‘Create Credentials’

4. Choose ‘OAuth Client ID’

5. On ‘Create OAuth client ID’

   a. Application type: Web Application

   b. Name: Gathr Analytics

   c. Authorized redirect URIs : Redirect URL of Gathr Analytics host. Ex.: https://HostName-123.Klera.com:48444/AccountManagementWebService/callback.html

NOTE: That the “HostName-123.klera.com” will be your organization’s HostName.domainName for the server where Gathr Analytics is deployed. Please replace this part with your Gathr Analytics 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 Analytics. You may need to create a DNS entry or configure proxy accordingly to make this URL accessible.

6. Copy Client ID and Client Secret and keep it safe. We will need this information in the next step.

Step 2: Import Google Sheets Application Template on Gathr Analytics.

1. Right click on the Floor -> Connectors -> Import

2. Browse the Application Template (Google Sheet connector). This process will generate a dataset “REST Application Data Sources”. Bring it on the Floor.

3. Right click on “Google Sheets Data Source” -> Connectors -> Connections -> Configure Enter the following details in the form:

   a. Instance URL: https://sheets.googleapis.com/v4

   b. Application Key: Client ID received from Step 1- #6.

   c. Application Secret: Client Secret received from Step-1 #6.

   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: Enter HostName with Domain Name used in step 1- #5.c Example: HostName-123.Kleramachine.com

   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.

4. Right-click on “Google Drive Data Source” ->select Connectors -> Connections -> Configure. Enter the following details in the form:

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

   b. Application Key: Client ID received from Step 1- #6.

   c. Application Secret: Client Secret received from Step 1 #6.

   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: HostName used in above Step 1- #5.c Example: HostName-123.Kleramachine.com

   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.

Step 3: Use Google Sheet Application Template

To start the analysis, right-click on the Floor -> Application Builder-> Google Sheet

• Search
• Spreadsheets.