All categories
System
Access management
AI
Appflows - Technical
Billing
Billing and policy
Built-in apps
Business cases addon
Business Intelligence
Business Operations and ERPs
Calendar addon
Commerce
Communication
Community apps
Contacts module
Contracts addon
CRM and Sales tools
Customer Support
Database
Education
Features
File and Document Management
Forms Addon (Legacy)
Getting started with Boost.space
HR management
Internet of Things
Invoices module
IT and Development
language-tools
Lifestyle
Marketing
Marketplace - Overview
Marketplaces
Modules and Addons
News monitor addon (legacy)
Notes addon
Offers addon
Orders module
Other
Pages addon
Policy
Process Management
Productivity
Products module
Projects addon
Records
Spaces
Surveys and Forms
System Settings (for Admins)
Tasks module
Travel
Users and teams
Wall addon
Warehouses addon
Website Building
Work hours addon
Integrations
Apps
Connections
Errors
Functions
Getting started with Boost.space Integrator
Integrator Modules
Mapping
Scenarios
Tools
Tutorials
List of applications
Table of Contents

Connecting to Google services using custom OAuth client

This article will show you how to create your own project in Google Cloud Console and a custom OAuth client. This is useful for connecting restricted Google services, like Google Drive or Gmail*,* to Boost space.

To connect, you must have a Google account. You can create an account at accounts.google.com/signin.

The following procedure is intended for:

  • Personal use (@gmail and @googlemail.com users)
  • Internal use (Google Workspace users that prefer to use a custom OAuth client)

Configure a Google Cloud Console project

Create a Google Cloud Console project

  1. Log in to the Google Cloud Console using your Google credentials.
  2. In the top menu, click Create or select a project > New project.
  3. Enter a Project name and select the Location for your project.
  4. Click Create.
  5. In the top menu, check if your new project is selected in the Select a project dropdown. If not, select the project you just created.

Enable APIs

  1. Open the left navigation menu and go to APIs & Services > Library.
  2. Search for the APIs you need for your project. For example: Gmail -> Gmail API.
  3. Click the needed API, then click Enable.

Configure your OAuth consent screen

  1. Go to APIs & Services > OAuth consent screen.
  2. Under User Type, select External. For more information regarding user types, refer to Google’s Exceptions to verification requirements documentation.
  3. Click Create.
  4. In the App information section, enter Boost.space as an app name and your Gmail address.
  5. In the Authorized domains section, add boost.space and celonis.com.
  6. In the Developer contact information section, enter your Gmail address.
  7. Click Save and continue.
  8. In the Scopes page, click Add or remove scopes, add any desired scopes, and click Update. Here are some examples of scopes you may need for Gmail and Google Drive.

Gmail

  • https://mail.google.com/

Google Drive

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  1. Click Save and continue.
  2. Optional: If your project will remain in the Testing publishing status, add test user emails on the Test users page, then click Save and continue.

Important Note on Publishing Status

Testing: If you keep your project in the Testing status, you will be required to reauthorize your connection in Boost space every week. To avoid weekly reauthorization, update the project status to In production.

In production: If you update your project to the In production status, you will not be required to reauthorize the connection weekly. To update your project’s status, go to the OAuth consent screen and click Publish app. If you see the notice Needs verification, you can choose whether to go through the Google verification process for the app or to connect to your unverified app. Currently connecting to unverified apps works in Boost space, but we cannot guarantee the Google will allow connections to unverified apps for an indefinite period.

Create your client credentials

  1. In the left sidebar, click Credentials.
  2. Click + Create Credentials > OAuth client ID.

  1. In the Application type dropdown, select Web application.
  2. Update the Name of your OAuth client. This will help you identify it in the console.
  3. In the Authorized redirect URIs section, click + Add URI and enter the redirect URI. Here are some examples of redirect URIs you may need:
  • https://integrator.boost.space/oauth/cb/google-restricted  https://integrator.boost.space/oauth/cb/google– for Gmail or Google Drive
  • https://integrator.boost.space/oauth/cb/google-custom – for Google Cloud Text-to-Speech
  • https://integrator.boost.space/oauth/cb/google-cloud-speech – for Google Cloud Speech
  • https://integrator.boost.space/oauth/cb/youtube – for YouTube
  • https://integrator.boost.space/oauth/cb/app – for any app created via Boost.space Developer Platform
  • https://integrator.boost.space/oauth/cb/google – for other Google apps
  1. Click Create.
  2. Copy your Client ID and Client secret values and store them in a safe place.

You will use these values in the Client ID and Client Secret fields in Boost space.

Establish the connection in Boost space

To establish the connection:

  1. Log in to your Boost space account, add a Google app module to your scenario, and click Create a connection.
  2. Optional: In the Connection name field, enter a name for the connection.
  3. Switch on the Show advanced settings toggle and enter your Google Cloud Console project client credentials.
  4. Click Sign in with Google.
  5. If prompted, authenticate your account and confirm access.

You have successfully established the connection. You can now edit your scenario and add more modules.