Collecting data from a Google source

    These instructions can be used for Intella, Intella Connect and Intella Investigator. The examples on this page will assume that Intella is used.


    This document provides instructions for configuring Google APIs to enable Intella to access data in Google accounts. In addition to this guide, it is recommended to refer to the relevant sections of the Intella user manual for adding sources to an Intella case.

    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

    Once you land on the Google API Console dashboard, click on the project selection dropdown list (see the following screenshot).



    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

    Once your project is created, you'll be redirected to the project dashboard. On the left sidebar, click on "Credentials." In the "Credentials" tab, click on "Create credentials" and select the type of credentials you want to create. For accessing Google APIs, choose "OAuth client ID".


    Step 4.1: Configure Consent Screen
    Before you can create a Client ID, you need to configure the Consent Screen. Click the "CONFIGURE CONSENT SCREEN" button. Then click the "Create" button. Provide all the necessary information on the "App Information" page.

    Once done, scroll to the bottom of the page and click on the Save button. Click "Save and continue" on the next pages until the Consent Screen is configured.

    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.



    Now, go back to Credentials and click again on Create -> OAuth Client ID.

    Step 4.2: Create a Desktop App OAuth Client ID (Intella)
    If you intend to use Intella for indexing Google sources, you must acquire a Desktop app OAuth Client ID. Follow these steps:
    1. In the "Application type" dropdown, select the "Desktop app" option.
    2. Provide a distinctive name for the client ID.
    3. Click on the Create button.


    Step 4.3: Create a Web app OAuth Client ID (Intella Connect / Intella Investigator)

    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:

    1. In the "Application type" dropdown, select the "Web application" option.
    2. Provide a distinctive name for the client ID.
    3. Add a new authorized JavaScript origin URI (e.g. https://connect.your-server.com:<port>).
    4. 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).


    After creating the credentials, you'll receive the necessary information, such as client ID and client secret. Make sure to copy and securely store this information, as it will be required to authenticate and access Google APIs.


    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.



    The dashboard will display a message indicating that no Google APIs have been set up for the new project (as shown in the screenshot below). To provide Intella with access to the supported Google services like Gmail, Google Drive, Google Contacts, or Google Calendar, you need to enable their respective Google APIs. To do this, navigate to the "Library" tab in the sidebar, search for the desired API, and click on it to enable it for your project. Intella supports the following Google APIs: Gmail API, Google Drive API, Google People API, Google Calendar API, and Google Tasks API.



    Step 5.1: Enable Gmail API if you want to access messages and folders in your Gmail

    To enable Gmail API, type "Gmail API" in the search bar. 



    Select the "Gmail API" from the results and click the "Enable" button to enable it for your project.



    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.



    Choose the Google services from the list from which you intend to index data and proceed to the next step.

      

    Browse for the OAuth token JSON file you downloaded from the Google API console project you created, and then click on the "Connect to Google" button.


    A new tab will open in your web browser for you to confirm this connection. You may see an 'App not verified' message. If that's the case, click on the advance button and then click on the link at the bottom to proceed to the Intella Google connector.



    Please review and select all the permissions listed, then click the Continue button to proceed. Please note that the list of permissions may vary depending on the Google services you have selected in the second step of the Add New Source wizard.



    If everything has been set up correctly, you will see a success message in the Connect to Google step, similar to the one shown in the screenshot below. Proceed with the remaining steps of the wizard as you would typically do with any other source.




    Published