Skip to main content

Google Workspace Google Workspace

Google Workspace (formerly known as Google Apps and later G Suite) is a collection of cloud computing, productivity and collaboration tools, software and products developed and marketed by Google.
It consists of Gmail, Contacts, Calendar, Meet and Chat for communication; Currents for employee engagement; Drive for storage; and the Google Docs suite for content creation.
An Admin Panel is provided for managing users and services.

Creating a Google Workspace connection​

info

To reduce the number of scopes, we recommend using separate connections for each of the following integrations rather than the general Google Workspace connection.

  1. Gmail
  2. Google Docs
  3. Google Drive
  4. Google Sheets

You can continue to use the general connection if you wish to do so.

Create the connection by using one of the following methods:

Ensure the relevant APIs from the following list are enabled:

info

You do not have to enable all APIs, only the ones relevant to the actions you wish to perform with Blink.

Stage One: The Google Workspace Platform​

note

Please note, when you hover when you move your cursor to the lower part of the arcade screen, navigation tabs will emerge. These tabs enable you to freely navigate through the tutorial at your convenience.

Creating a Service Account​

This step is only necessary if you don't already have a service account.

  1. In the Google Cloud console, go to the Create service account page.

  2. Enter a name in the Service account name field.

    • (optional) Edit the service account ID.
    • (optional) If you want to grant the service account access to the project, or to grant users access to this service account, click on Create and continue. This is not required for the integration with Blink.

  3. Click Done to finish creating the service account.

Create a Service Account Key​

  1. In the Google Cloud console, go to the service account page.

  2. Select the service account that you want to create a key for.

  3. Click the Keys tab.

  4. From the dropdown menu, select Add key > Create new key.

  5. Select JSON as the key type and click Create.

  6. Copy the key.

Enable service account delegation in your Google Workspace​

  1. In the Google Admin console, go to the API controls page and then click on Manage domain wide delegation.

  2. Add a new client to your workspace. In Client ID, use the client ID from the downloaded JSON service account from the previous step.

  3. To allow all actions in Blink to run, add the following scopes used by Blink to access your Google APIs:

    https://www.googleapis.com/auth/admin.directory.rolemanagement,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/admin.directory.user.security,
    https://www.googleapis.com/auth/admin.directory.group,
    https://www.googleapis.com/auth/admin.directory.group.member,
    https://www.googleapis.com/auth/admin.datatransfer,
    https://www.googleapis.com/auth/apps.licensing,
    https://mail.google.com,
    https://www.googleapis.com/auth/drive,
    https://www.googleapis.com/auth/apps.alerts,
    https://www.googleapis.com/auth/spreadsheets,
    https://www.googleapis.com/auth/cloud-identity.devices,
    https://www.googleapis.com/auth/admin.directory.orgunit.readonly
    Note #1

    You can adjust the scopes according to your requirements.

    Note #2

    It usually takes a few minutes for impersonation access to be granted after the client ID was added.

  1. In the Blink platform, navigate to the Connections page > Add connection.

  2. Select the Google Workspace icon. A dialog box with name of the connection and connection methods appear.

  3. Optional- Edit the name of the connection. At a later stage you cannot edit the name.

  4. Select Service Account as the method to create the connection.

  5. Fill in the parameters:

    • Paste the JSON key into the Credentials field.

    • Specify the email address of the Delegated User for which Blink will use for access.
      Many actions contain a Delegated User Override parameter which lets you perform specific operations on behalf of a different user.
      When this parameter is not specified, it will default to the one provided in the connection.

      note

      The delegated user has to be a user in the same domain. For the list of the available users, navigate to the users tab.

    • A comma-separated list of Scopes you want this connection to request. This list should not exceed the scopes you added in your domain-wide delegation.

OR

  1. Click Google Workspace as the method to create the connection using OAuth.

  2. Sign in using your credentials.

  3. Optional- Click Test Connection to test it.

  4. Click Create connection. The new connection appears on the Connections page.