AI Docs

Creating a G Suite Connector

3 min read

Creating a G Suite Connector

Managing API client access to G Suite

The Certero connector for G Suite uses Google G Suite’s APIs to connect and retrieve data from G Suite.  The G Suite APIs use industry standard OAuth 2.0 protocols for authentication and authorization.

For more information on what OAuth is and how this flow works between an endpoint server and G Suite, please see the following link:

Google OAuth2 Overview

To setup a connection with Certero, within G Suite you will need to:

  • Turn on API access.

  • Create the required authorisation tokens to allow the Certero for Cloud G Suite connector to access data.

  • Client Id

  • Client Secret

Enabling the G Suite API

  1. Sign into your Google Admin console using an administrator account , not a standard user or G Suite user account.

  2. From the Admin Console home page, click on the Security option.

Note: To see Security on the home page, you might have to click More controls at the bottom if you are accessing the console from a mobile or tablet device.

1. Scroll down to Advanced Settings and click on API Permissions

2. Click API Reference and under API Access click on Enable API Access

Note: To avoid confusion, you do not need to do anything with the Admin SDK option that may or may not be listed under this section.

Creating the G Suite Credentials

1. Sign into your Google Developer console using an administrator account , not a standard user or G Suite user account.

2. From the Developer Console home page, click on Credentials.

3. At the top of the screen click on Create Credentials and select OAuth client ID.

4. In the Create OAuth client ID screen, set the Application Type to ‘Web Application and give it a name that you can easily identify, such as ‘Certero Endpoint’.

5. Enter the link: https://cc.certero.com/cmp/AuthorizeGSuiteConnector in the Authorized redirect URIs.

6. Click Create.

7. The client id and client secret are displayed. Make a note of the client Id and client secret they are required in the Certero G Suite connector.

Note:  The client id and client secret can always be viewed in the APIs & Services >> Credentials screen.

Create a new Google G Suite Connector

Enable the feature for the Endpoint Server.

  1. In Certero >> Administration >> Endpoint Servers, right click on the endpoint server the Google G Suite connector will be ran against and choose properties.

  2. Click on the Features option.

  3. Enable the Google G Suite Connector row.

  4. Click on Save.

Create a connector for Google G Suite.

1. In Certero >> Connectors >> Google G Suite Connectors, click the ‘New’ button.

2. Add a name and description.

3. Copy and paste the Client ID into the Client ID

4. Copy and paste the Client Secret into the Client Secret

5. Click the Authorise.

You may be asked to sign in. Sign in using the admin username and password.

6. Click Next

7. Click Allow.

A Token is displayed:

8. Copy the Token value from the confirmation page to the Token in the connector dialog.

9. Set the required schedule.

10. Click on Save.