Google Drive Integration

Overview

Bring your Google Drive documents into Conveyor AI. This integration makes it easy to keep your documentation up to date while maintaining complete control over what content is accessible. Documents will automatically be pulled from Google Drive into Conveyor AI using secure service account authentication.

Key Features:

• Granular Security: Only files you explicitly share with the service account are accessible
• No Drive-Wide Access: Complete control over what Conveyor can see

Prerequisites

This integration requires coordination between different roles in your organization:

For IT Administrators

• Access to your organization's Google Cloud Platform console
• Permissions to enable APIs and create service accounts in GCP
• Google Workspace Admin Console access (for Google Groups setup)

For Conveyor Administrators

• Access to a Conveyor Admin account
• Coordination with IT team to obtain service account credentials

For End Users

• Access to Google Drive files/folders you want to integrate
• Permission to share files and folders in Google Drive
• Understanding of what content should be accessible to Conveyor

Installation

For detailed instructions, see: Google Drive Service Account Setup Guide

Step 1: Set Up Service Account (IT Administrator)

Before configuring the integration in Conveyor, your IT Administrator needs to create a Google Cloud Platform service account. This is a one-time setup process.

Quick Summary:

1. Enable Google Drive API in Google Cloud Platform
2. Create a service account with Viewer permissions
3. Generate JSON credentials for the service account
4. (Recommended) Create a Google Group and add the service account as an external member
5. Securely provide credentials to Conveyor Administrator

Step 2: Enable the Google Drive Integration (Conveyor Administrator)

As a Conveyor Admin:

1. Navigate to the Organization Preferences page
2. Click "Add Integration"
3. Select "Google Drive"
4. Upload the JSON credentials file provided by your IT Administrator
5. Test the connection to verify the integration is working

Step 3: Share Files with Your Service Account

After the integration is configured, you need to share Google Drive files and folders with your service account to make them accessible to Conveyor.

For detailed instructions, see: Sharing Files with Your Service Account Guide

Quick Summary:

1. Obtain your service account email or Google Group email from your Conveyor Administrator
2. Share individual files or entire folders with the service account
3. Verify shared content appears in Conveyor's External Sources

Step 4: Add Files and Folders from Google Drive

📘

Supported File Types in Google Drive

Currently supports Google Docs, Google Slides, PDF files, and plain text files. Google Sheets support coming soon.

As a user with shared content:

1. Navigate to the External Sources page of your Knowledge Base
2. Click "Add Knowledge" and select "Google Drive"
3. Browse and select from files and folders you've shared with the service account
4. Choose individual files or entire folders based on your needs
5. Conveyor will sync the selected content automatically
6. Your content will show up on your External Sources page as cards

File Synchronization Behavior

Individual File Selection

When you select individual files, only those specific files will be synced to your knowledge base. If new files are added to the same folder later, they will not be automatically included.

Folder Sync (Dynamic Sync)

When you select an entire folder for sync, the system will:

• Sync all current files and subfolders within that folder
• Automatically include new files added to that folder in the future
• Recursively sync all nested subfolders and their contents
• Continue monitoring the folder for changes during daily sync cycles