These instructions can be used for Intella, Intella Connect and Intella Investigator. The examples on this page will assume that Intella is used.
Step 1: Go to Google API Console
Visit the Google API Console at console.developers.google.com.
Step 2: Log in to the Google account from which you want Intella to index data for your case
Please ensure you are signed in to the Google account from which you want Intella to index artifacts. You can access the avatar in the top right corner, as depicted in the screenshot below. If the displayed account is incorrect, please choose the appropriate account from the list or add it manually if it is not listed.
Step 3: Create a New Project
Click on the New Project button at the top right of this form to set up a new project.
Enter a name for the project (e.g. ‘Intella Google Connector’), and then click the Create button.
Step 4: Create OAuth Credentials
After saving the Google consent screen details, return to the "OAuth consent screen" tab on the left sidebar and click the "Publish App" button.
Once the application has been published in production, you will see the verification status shown in the screenshot below.
- In the "Application type" dropdown, select the "Desktop app" option.
- Provide a distinctive name for the client ID.
- Click on the Create button.
If you intend to use Intella Connect or Intella Investigator for indexing Google sources, you must acquire a Web App OAuth Client ID. Follow these steps:
- In the "Application type" dropdown, select the "Web application" option.
- Provide a distinctive name for the client ID.
- Add a new authorized JavaScript origin URI (e.g. https://connect.your-server.com:<port>).
- Add a new authorized redirect URI, ensuring it includes the mandatory path "public/oauth/google-oauth-callback.html" (e.g., https://connect.your-server.com:<port>/public/oauth/google-oauth-callback.html).
You can use the download button on the far right to download the client secret JSON file.
Step 5: Enable Google APIs
Open the project selection dropdown again and choose the project you created. You will land on the project's dashboard page.
Step 5.1: Enable Gmail API if you want to access messages and folders in your Gmail
Step 5.2: Enable Google Drive API if you want to access and index data in your Google Drive
To enable Google Drive API, type "Google Drive API" in the search bar.
Select the "Google Drive API" from the results and click the "Enable" button to enable it for your project.
Step 5.3: Enable Google People API if you intend to access and index contacts in your Google account.
To enable Google People API, type "Google People API" in the search bar.
Select the "Google People API" from the results and click the "Enable" button to enable it for your project.
Step 5.4: Enable Google Calendar API if you intend to index calendars and events in your Google account.
To enable Google Calendar API, type "Google Calendar API" in the search bar.
Select the "Google Calendar API" from the results and click on the "Enable" button to enable it for your project.
Step 5.5: Enable Google Tasks API to enable Intella to index scheduled tasks and TODOs in your Google account.
To enable Google Tasks API, type "Google Tasks API" in the search bar.
Select the "Google Tasks API" from the results and click on the "Enable" button to enable it for your project.
Step 5.6: Enable the Google Chat API if you intend to index Google Chat spaces.
To enable the Google Chat API, type "Google Chat API" in the search bar.
Select the Google Chat API from the result and click on the "Enable" button to enable it for your project.
Upon enabling the Google Chat API, finalize the Configuration form.
Fill out the highlighted settings and Save the settings.
Step 5.6: Enable the Google Meet REST API if you intend to index Google Meet calls and conferences.
To enable the Google Meet REST API, type "Google Meet" in the search bar.
Select the Google Meet REST API from the result and click on the "Enable" button to enable it for your project.
Step 7: Add a Google source
Open your Intella case, start the Add Source wizard, select the "Google" option on the Source Type page and proceed to the next step.