← All Articles

Importing Documents from Google Drive

integrations beginner integrations google-drive document-import oauth knowledge-bases

SecureAI's Google Drive integration lets administrators connect their organization's Google Drive so that documents, spreadsheets, and PDFs stored in Drive are automatically indexed and available in conversations. This article walks through the full setup process — from OAuth authentication to selective folder sync — and covers how users interact with imported Drive content.

Prerequisites

Before you begin, confirm the following:

Step 1: Connect Google Drive via OAuth

SecureAI uses OAuth 2.0 to authenticate with Google Drive. This means you sign in with your Google account and grant SecureAI permission to read files — no API keys or service accounts are required.

  1. In the SecureAI admin panel, go to Settings > Integrations > Google Drive.
  2. Click Connect Google Drive.
  3. A Google sign-in window appears. Sign in with your Google Workspace account.
  4. Review the permissions SecureAI is requesting:
    • View files and folders in your Google Drive (read-only)
    • View metadata for files and folders
  5. Click Allow to grant access.
  6. You are redirected back to the SecureAI admin panel. A green confirmation banner confirms the connection is active.

SecureAI requests read-only access. It cannot create, edit, move, or delete files in your Google Drive.

Choosing the Right Account

Use a shared service account or a team admin account rather than a personal account. The connected account determines which files SecureAI can see — it can only index files that account has access to. If you connect with your personal account and later leave the organization, the integration will break.

Revoking Access

To disconnect Google Drive, return to Settings > Integrations > Google Drive and click Disconnect. You can also revoke access from your Google Account at myaccount.google.com/permissions.

Step 2: Select Folders to Sync

After connecting, you choose which Drive folders SecureAI should index. This is selective sync — SecureAI does not index your entire Drive by default.

  1. On the Google Drive integration page, click Select Folders.
  2. A folder browser appears showing your Drive structure, including Shared Drives.
  3. Check the folders you want to import. You can select:
    • My Drive folders owned by the connected account
    • Shared Drive folders your organization has set up
    • Shared with me folders that others have shared with the connected account
  4. Click Save Selection.

Best Practices for Folder Selection

Step 3: Configure File Types and Indexing

SecureAI can index the following file types from Google Drive:

File Type Indexed Content
PDF Full text extraction, including scanned PDFs with OCR
Google Docs Full document text
Google Sheets Cell values (formulas are not evaluated)
DOCX Full document text
XLSX Cell values
TXT / CSV Full text content
Google Slides Slide text content (images on slides are not indexed)

File Size Limits

Setting the Re-Index Interval

SecureAI periodically checks your selected folders for new, updated, or deleted files.

  1. On the Google Drive integration page, find the Re-index Interval setting.
  2. Choose an interval:
    • Every 15 minutes — Best for folders with frequently changing documents.
    • Every hour (default) — Good balance for most teams.
    • Every 6 hours — Suitable for stable document libraries that rarely change.
    • Daily — For archived content that changes infrequently.
  3. Click Save.

You can also trigger a manual re-index at any time by clicking Re-index Now.

Step 4: Verify the Import

After saving your folder selection and indexing settings:

  1. Click Re-index Now to trigger the first sync.
  2. The integration page shows a progress indicator: files discovered, files indexed, files skipped.
  3. Once indexing completes, go to Admin Panel > Knowledge Bases to confirm the imported documents appear.
  4. Open a conversation and ask a question that references content from one of your Drive documents. For example: "What does the 2026 Dorman catalog say about part number 523-1234?"

If the AI references your Drive content in its response, the import is working correctly.

Troubleshooting Import Issues

Problem Likely Cause Solution
No files appear after re-index Folder selection is empty or account lacks access Re-check folder selection; verify the connected account can access the folders
Some files are missing File type is not supported or file exceeds size limit Check file types and sizes; convert unsupported formats
Stale content in responses Re-index hasn't run since the file was updated Click Re-index Now or reduce the re-index interval
"Authentication expired" error OAuth token has expired or been revoked Click Reconnect on the integration page to re-authenticate
Shared Drive folders not visible Connected account is not a member of the Shared Drive Add the connected account as a member of the Shared Drive in Google Admin

How Users Interact with Drive Documents

Once documents are imported, they behave like any other knowledge base content in SecureAI. Users do not need to know whether content came from Google Drive, a direct upload, or another integration.

Users can:

Users cannot:

Managing the Integration Over Time

Adding or Removing Folders

Return to Settings > Integrations > Google Drive > Select Folders at any time to add or remove folders from the sync. Removed folders are de-indexed within one re-index cycle — their content will no longer appear in conversations.

Monitoring Sync Status

The Google Drive integration page shows:

Switching the Connected Account

If you need to switch the Google account used for the integration:

  1. Click Disconnect on the integration page.
  2. Click Connect Google Drive and sign in with the new account.
  3. Re-select the folders to sync (folder selections are not preserved across account changes).

Data Retention

Imported Drive documents follow the same retention policies as other SecureAI content. If you have configured data retention policies (see Configuring Data Retention Policies), they apply to Drive-imported content as well.

Deleting a file from Google Drive does not immediately remove it from SecureAI. The file is de-indexed on the next re-index cycle based on your configured interval.

Security Considerations

Related Articles