Gmail OAuth Integration Guide

This guide explains how to set up a Google OAuth 2.0 integration for AINexLayer to connect your Gmail account.

Step 1: Accessing the Google Cloud Console

1. Navigate to Google Cloud Console
2. Select an existing project or create a new one

Step 2: Enabling Required APIs

1. Go to APIs & Services > Library
2. Search for and enable the following APIs:
   • People API (required for Google OAuth)
   • Gmail API (required for Gmail connector)

Step 3: Configuring OAuth Consent Screen

1. Go to APIs & Services > OAuth consent screen
2. Select External user type (or Internal if using Google Workspace)
3. Fill in the required information:
   • App name: AINexLayer
   • User support email: Your email address
   • Developer contact information: Your email address
4. Click Save and Continue

Adding Scopes

1. Click Add or Remove Scopes
2. Add the following scopes:
   • https://www.googleapis.com/auth/gmail.readonly - Read Gmail messages
   • https://www.googleapis.com/auth/userinfo.email - View user email address
3. Click Update and then Save and Continue

Step 4: Creating OAuth Client ID

1. Go to APIs & Services > Credentials
2. Click Create Credentials > OAuth client ID
3. Select Web application as the application type
4. Enter Name: AINexLayer
5. Under Authorized redirect URIs, add:

   http://localhost:8000/api/v1/auth/google/gmail/connector/callback

6. Click Create

Step 5: Obtaining OAuth Credentials

1. After creating the OAuth client, you'll see a dialog with your credentials
2. Copy your Client ID and Client Secret

Deploying AINexLayer with Gmail Connector

Add the Google OAuth credentials to your .env file (created during Docker installation):

GOOGLE_OAUTH_CLIENT_ID=your_google_client_id
GOOGLE_OAUTH_CLIENT_SECRET=your_google_client_secret
GOOGLE_GMAIL_REDIRECT_URI=http://localhost:8000/api/v1/auth/google/gmail/connector/callback

Then restart the services:

docker compose up -d