Reco

The user performing the integration must be a G-Suite Administrator

1. The user performing the integration must be a G-Suite Administrator
2. A Reco user with Admin Role

1. Go to <a href="https://console.developers.google.com/iam-admin/serviceaccounts" rel="nofollow noopener noreferrer" target="_blank">https://console.developers.google.com/iam-admin/serviceaccounts</a>

-Click on "Create" and wait for the creation to finish

2. Click on "Create Service Account"

-Service Account Name: “Reco-gmail-connector’

-Service Account ID: Automatically Prefilled

-Service Account Description: ‘Enter Description’

-Copy the Client ID found under ‘Domain-wide delegation’

4. In a new tab, navigate to <a href="https://admin.google.com/ac/owl/domainwidedelegation" rel="nofollow noopener noreferrer" target="_blank">https://admin.google.com/ac/owl/domainwidedelegation</a>

<a href="https://www.googleapis.com/auth/gmail.readonly" rel="nofollow noopener noreferrer" target="_blank">https://www.googleapis.com/auth/gmail.readonly</a>

<a href="https://www.googleapis.com/auth/gmail.metadata" rel="nofollow noopener noreferrer" target="_blank">https://www.googleapis.com/auth/gmail.metadata</a>

<a href="https://www.googleapis.com/auth/admin.directory.user.readonly" rel="nofollow noopener noreferrer" target="_blank">https://www.googleapis.com/auth/admin.directory.user.readonly</a>

- <a href="https://www.googleapis.com/auth/gmail.readonly" rel="nofollow noopener noreferrer" target="_blank">https://www.googleapis.com/auth/gmail.readonly</a>
- <a href="https://www.googleapis.com/auth/gmail.metadata" rel="nofollow noopener noreferrer" target="_blank">https://www.googleapis.com/auth/gmail.metadata</a>
- <a href="https://www.googleapis.com/auth/admin.directory.user.readonly" rel="nofollow noopener noreferrer" target="_blank">https://www.googleapis.com/auth/admin.directory.user.readonly</a>

5. Navigate back to the previous tab for the Google Cloud Admin Console

-At this point, Google will automatically create the file and download it to the computer

-Add the key-value pair: "admin_email": "&lt;email of google workspace admin&gt;"

6. Click on the Google Cloud Platform Navigation Menu (3 Lines At the Top Left of the page)

Click on "Configurations" then click on "Integrations"

Locate the "Gmail" object and click on "Add Integration"

Copy the contents of the previously downloaded file (after you added the "admin_email" key) and paste it in the UI and click on "Allow"

Select the start date you would like to ingest metadata from, and click on "Start Extraction"

If the integration was successful, the Gmail Integration status will become "Active"

1. Login to the Reco Platform
2. Click on "Configurations" then click on "Integrations"
3. Locate the "Gmail" object and click on "Add Integration"
 
 

4. Click on "Allow"
 
 
 
5. Copy the contents of the previously downloaded file (after you added the "admin_email" key) and paste it in the UI and click on "Allow"
 
 
 
6. Select the start date you would like to ingest metadata from, and click on "Start Extraction"
 
 
 
7. If the integration was successful, the Gmail Integration status will become "Active"

Scope Name	Allows access to	Reference
gmail.readonly	Read all resources and their metadata—no write operations	Google Documentation
gmail.metadata	Read resources metadata including labels, history records, and email message headers, but not the message body or attachments	Google Documentation
admin.directory.user.readonly	Scope for only retrieving users or user aliases	Google Documentation

Prerequisites

Configure Google

Integrate Gmail with Reco

What do we ingest exactly?