> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive Data Ingestion

> Import Google Drive files as knowledge sources

Turn your Google Drive into AI knowledge. Import documents, spreadsheets, PDFs, and Word files so your Guru can answer questions based on your team's files.

## Why Ingest Google Drive Data?

<CardGroup cols={2}>
  <Card title="Docs & Spreadsheets" icon="file-lines">
    Import Google Docs, Sheets, PDFs, Word files, and text files
  </Card>

  <Card title="Share & Sync" icon="share-nodes">
    Simply share files with a service account to index them
  </Card>

  <Card title="Auto-Sync" icon="rotate">
    Files stay in sync — edits are automatically re-indexed
  </Card>

  <Card title="Automatic Labels" icon="tag">
    Imported files are automatically labeled `google_drive`
  </Card>
</CardGroup>

## Supported File Types

| File Type          | Format          | Notes                           |
| ------------------ | --------------- | ------------------------------- |
| **Text Files**     | `.txt`, `.md`   | Plain text and Markdown         |
| **Spreadsheets**   | `.xls`, `.xlsx` | Excel format                    |
| **PDFs**           | `.pdf`          | Portable Document Format        |
| **Word Documents** | `.docx`         | Microsoft Word format           |
| **Google Docs**    | Native          | Processed directly as Docx      |
| **Google Sheets**  | Native          | Automatically converted to XLSX |

<Note>
  Only supported file types are indexed. Other files are skipped during sync.
</Note>

***

## Setup

### Step 1: Create Google Cloud Service Account

<Steps>
  <Step title="Open Google Cloud Console">
    1. Go to [Google Cloud Console](https://console.cloud.google.com/)
    2. Navigate to **IAM & Admin** → **Service Accounts**
    3. Select or create a project

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/service_accounts.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=dbf737b9cc13a811735ff887bce32dbf" alt="Google Cloud Console Service Accounts page" width="4604" height="2076" data-path="images/ingestion/google_drive/service_accounts.png" />
    </Frame>
  </Step>

  <Step title="Create Service Account">
    1. Click **Create Service Account**
    2. Enter a name (e.g., "Gurubase Integration")
    3. Click **Create and Continue**
    4. Skip permissions and principals steps
    5. Click **Done**

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/create_service_account.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=3964de60160cdeaaa2bd96a1ca85f7c9" alt="Create Service Account dialog" width="4586" height="1890" data-path="images/ingestion/google_drive/create_service_account.png" />
    </Frame>
  </Step>

  <Step title="Download JSON Key">
    1. Click on your new service account
    2. Go to **Keys** tab
    3. Click **Add Key** → **Create new key**
    4. Select **JSON** and click **Create**
    5. Save the downloaded file securely

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/sa_key.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=3cf1518216a22e9834ac71471f16b672" alt="Service Account Keys tab" width="4614" height="1974" data-path="images/ingestion/google_drive/sa_key.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/create_key.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=4f4d2c1210a569fd96b2af2242d17d55" alt="Create new key dialog" width="1474" height="906" data-path="images/ingestion/google_drive/create_key.png" />
    </Frame>
  </Step>

  <Step title="Enable Google Drive API">
    1. Go to **APIs & Services** in the console
    2. Click **Enable APIs and services**
    3. Search for **Google Drive API**
    4. Click **Enable**

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/enable_google_drive_api.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=0b80961bb9387b8aa1e50a0c82fef052" alt="Enable Google Drive API" width="2354" height="1474" data-path="images/ingestion/google_drive/enable_google_drive_api.png" />
    </Frame>
  </Step>
</Steps>

### Step 2: Connect to Gurubase

<Steps>
  <Step title="Navigate to Google Drive Integration">
    Go to **Gurubase Dashboard** → Select your Guru → **Integrations** → **Ingestions** → **Google Drive**

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/empty_integration.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=726abfcb8e493ef384944974cf70703a" alt="Empty Google Drive integration state" width="3840" height="1818" data-path="images/ingestion/google_drive/empty_integration.png" />
    </Frame>
  </Step>

  <Step title="Upload JSON Key">
    Paste or upload the JSON key file and click **Connect**

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/no_files_shared.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=55c06e48eb84341f4e9971b02abb8693" alt="No files shared message" width="3340" height="1206" data-path="images/ingestion/google_drive/no_files_shared.png" />
    </Frame>
  </Step>
</Steps>

### Step 3: Share Files with Service Account

<Steps>
  <Step title="Share Files in Google Drive">
    1. Go to your Google Drive
    2. Select files or folders to index
    3. Click **Share**
    4. Enter the service account email (shown on the integration page or in the JSON key as `client_email`)
    5. Set permission to **Viewer**
    6. Click **Send**

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/share_files.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=ee1a32a52a4d3fdc43d98746060f2b89" alt="Share files with service account in Google Drive" width="1022" height="860" data-path="images/ingestion/google_drive/share_files.png" />
    </Frame>
  </Step>

  <Step title="Sync Files">
    1. Return to Gurubase integration page
    2. Click **Sync Now** to start indexing

    <Frame>
      <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/shared-synced.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=eaafe3e53fcf2c8243e5334a4217949f" alt="Shared and synced files" width="3344" height="1796" data-path="images/ingestion/google_drive/shared-synced.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Share entire folders to automatically index all files inside. New files added to shared folders will be indexed on the next sync.
</Tip>

***

## Viewing Indexed Content

Imported files appear as individual sources in your Guru's data sources list with the `google_drive` label. You can:

* View the exact content that was indexed
* See when files were last synced
* Remove specific files from your Guru

<Frame>
  <img src="https://mintcdn.com/gurubase/ctsOOUyo4w0lt_O8/images/ingestion/google_drive/last_indexed_at.png?fit=max&auto=format&n=ctsOOUyo4w0lt_O8&q=85&s=4fc21eb9d327b01358b6b5839d78a2fe" alt="Last indexed timestamp" width="1246" height="1228" data-path="images/ingestion/google_drive/last_indexed_at.png" />
</Frame>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Confluence Ingestion" icon="confluence" href="/integrations/ingestion/confluence">
    Import Confluence pages
  </Card>

  <Card title="Slack Ingestion" icon="slack" href="/integrations/ingestion/slack">
    Import Slack conversations
  </Card>

  <Card title="Zendesk Ingestion" icon="headset" href="/integrations/ingestion/zendesk">
    Import Zendesk tickets and articles
  </Card>

  <Card title="Data Sources" icon="database" href="/guides/data-sources">
    Add more knowledge sources
  </Card>
</CardGroup>
