​
Overview

The Google Workspace connector allows you to access, manage, and synchronize data across Gmail, Google Calendar, and Google Drive.

Google Workspace (formerly G Suite) is a collection of cloud computing, productivity, and collaboration tools developed by Google. This connector provides access to core Google Workspace services through a unified API.

​
Authentication

The Google Workspace connector uses OAuth 2.0 for authentication. This requires users to grant permission for the application to access their Google Workspace data within the scopes specified.

​
Obtaining credentials

  1. To obtain credentials for a Google Workspace connector, you need to create Oauth Client in the Google Cloud Console, assign the scopes, and add Redirect Uri.
  2. Access the Google Cloud Console: Go to the Google Cloud Console.
  3. Create a project (if you don’t have one) - Configure OAuth consent screen - Create OAuth client ID (Web application) - Note your Client ID and Client Secret
  4. Redirect Uri must be (http://your-frontend-dns/account/individual/settings/connector/googleWorkspace)
  5. In the Data access Tab in google cloud console , add the scopes for gmail,calendar and google drive.

    Redirect Uri must match exactly frontend url. For example: if you app is running on https://f7f0-240.ngrok-free.app then redirectUri should be https://f7f0-240.ngrok-free.app/account/individual/settings/connector/googleWorkspace in Google Cloud Console.

​
Configuring and enabling connector

  1. Navigate to the Connectors tab under settings tab in Company Profile

  2. Click on “Click to View” Button.

  3. If not configured, click on settings button which will open a configuration dialog.

  4. In the Configuration Dialog

    • Enter the Google Client ID and Google Client Secret.
    • Click on save button.

  5. To enable the connector, click on the enable button, you will be redirected to consent screen from google ,you have to sign in and give consent for all the connectors like gmail, drive, calendar for sharing the data.

  6. After giving consent, it will redirect to the frontend and if the Google Workspace shows enabled, then your connector is successfully configured and enabled.

Give consent will the same email as used for email in pipeshub.

For setting up Google PubSub notifications, please refer to the Google PubSub Configuration Guide in the Enterprise documentation.