API Provider Setup

To authenticate a Google Suite element instance you must create a project with a web application in the Google API console. After you create the project and app, Google provides a Client ID and Client secret which you will use to authenticate an element instance. You'll also need the Authorized redirect URI that you configure while creating the app.

When you set up your app, you must also enable the following Google APIs:

• Google People API
• GMail API
• Google Calendar API

If you've already set up an app and just need to know how to find your Client ID and Client secret, see Locate Credentials for Authentication. If you need to create a project and register an app, see Create an Application.

See the latest setup instructions in the Google API documentation.

Locate Credentials for Authentication

If you already created a project and application, follow the steps below to locate the Client ID, Client secret, and Authorized redirect URI. If you have not created an app, see Create an Application.

To find your OAuth 2.0 credentials:

1. Log in to your account at Google.

2. Click Select a project, choose your project from the list, and then click Open.

   Google displays your apps and associated Client ID.

3. Click the pencil icon to see the Client ID, Client secret, and Authorized redirect URI.

4. Record the Client ID and Client secret.

5. Record the Authorized redirect URI for your app.

Create an Application

If you have not already created a project and application, you need one to authenticate with Google. Creating an application is a multi-step process:

1. Create a project
2. Enable APIs
3. Create a web application

Create a Project

To create a project:

1. Log in to your account at Google.
2. Click Select a project and click the Create Project button.
3. Accept the terms of service.
4. Complete the required information (Project Name, email updates, and the Terms of Service).
5. Click Create.

Enable APIs

To make all of the requests available in the Google Suite element, you must enable the following APIs

• Google People API
• GMail API
• Google Calendar API

To enable APIs:

1. Select the project that you just created
2. Click Enable APIs and Services.
3. Search for and enable the Google People API, GMail API, and Google Calendar API.

Create a Web Application

1. Click Credentials on the left menu.
2. Click the OAuth consent screen tab.
3. Enter a Product Name and add any optional information, and then click Save.
4. Click Create Credentials, and then select OAuth Client ID.
5. Select Web application as the Application type.
6. Enter a Name and the Authorized redirect URI for your app. Record this as the OAuth Callback URL that you will need to authenticate.
7. Click Create.
8. Record the Client ID and Client secret to use when you authenticate.

Next authenticate an element instance with Google Suite.