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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/integrations/ai/google-drive",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Google Drive AI integration

> Extend the Omni Agent with search and file retrieval from your Google Drive, so you can reference documents and spreadsheets alongside your data analysis.

export const integration_0 = "Google Drive"

Omni's Google Drive AI integration extends the Omni Agent with the ability to search and retrieve files from Google Drive. This allows you to reference documents, spreadsheets, and other shared files alongside your data analysis workflows. Using the Google Drive integration, you could:

* **Reference source documents** - Pull context from a strategy doc, PRD, or spec while analyzing the corresponding data in Omni
* **Validate definitions** - Check a shared spreadsheet or glossary to verify how a metric is defined before using it in analysis
* **Incorporate supporting material** - Surface reports, notes, or documentation relevant to the question you're asking

For example, you could ask: *"Find our churn definition doc and then show me the churn rate by segment for last quarter"* - combining document context with data analysis in a single conversation.

## Common questions

<AccordionGroup>
  <Accordion title="What can the Omni Agent access?">
    Every Omni user that wants to use the Google Drive AI integration must connect their Google account. This means that the Omni Agent will have the same permissions as the prompting user, accessing only the files and folders they have access to.
  </Accordion>

  <Accordion title="How are file contents processed?">
    File search results and file contents are processed the same way as other AI features in Omni. Refer to [AI data privacy](/ai/security) for more information.
  </Accordion>
</AccordionGroup>

## Setting up the Google Drive integration

See [Setting up Google AI integrations](/integrations/ai/google-setup) for help setting up the Google Drive integration for your Omni organization.

After Google Drive is set up, each user in your Omni organization must connect their individual accounts in their [user settings](/administration/users/your-account) to use the integration.

<h2 id="connect-user-account">
  Connecting your Google Drive account
</h2>

<Note>
  **This section applies to all users**, not only {integration_0} admins. Every user who wants to use the {integration_0} AI integration must connect their {integration_0} account.
</Note>

After the {integration_0} AI integration is enabled for your Omni organization, users will need to connect their individual {integration_0} accounts to use the integration:

<Steps>
  <Step noAnchor>
    In Omni, click your user icon and then [**Manage account**](/administration/users/your-account).
  </Step>

  <Step noAnchor>
    Scroll down to the **Connected Services** section.
  </Step>

  <Step noAnchor>
    Next to the **{integration_0}** integration, click **Connect**.
  </Step>

  <Step noAnchor>
    Complete the authentication flow to connect your account.
  </Step>
</Steps>

## Using Google Drive in the Omni Agent

<Note>
  Before users can use Google Drive with the Omni Agent, they will need to connect their Google accounts in their [user settings](/administration/users/your-account).
</Note>

Once your Google Drive account is connected, you can ask the Omni Agent to search for files or retrieve the contents of specific documents from Drive.

### Searching files

The Omni Agent can search across the files you have access to in Google Drive. To search for files, ask questions like:

* "Find our Q3 planning doc in Drive"
* "Search Drive for spreadsheets about pricing experiments"
* "Look for the onboarding playbook shared by the marketing team"

The Agent returns matching files in the chat, including:

* File name
* Owner and last modified date
* A snippet or summary of the contents
* Direct link to the file in Google Drive

### Retrieving file contents

You can also ask the Omni Agent to retrieve the full contents of a specific file:

* "Show me the contents of the churn definition doc"
* "Fetch the pricing model spreadsheet and summarize the tiers"
* "Get the latest revision of the product strategy doc"

The Agent returns the file contents inline, so you can review documents and spreadsheets without leaving Omni.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Failed to connect Google Drive error">
    This error can be caused by:

    * An incorrect or rotated client secret
    * An incorrect callback URL
    * An expired authorization code. Codes are single-use and expire after a short period.
  </Accordion>

  <Accordion title="Google Drive tools not appearing in the Omni Agent">
    Tools will only become accessible after an individual user connects their Google account in their user settings. Verify that the user has [connected their Google Drive account](#connect-user-account).
  </Accordion>

  <Accordion title="Files not appearing in search results">
    If a user can't find a file they expect to see:

    * The user may not have access to the file in Google Drive
    * The file may be in a shared drive that requires additional permissions
    * The user may need to re-authorize the integration to refresh their access scopes
  </Accordion>
</AccordionGroup>

## Next steps

* [Explore the Omni Agent](/ai/chat) to learn more about conversational data analysis
* [Optimize your models for AI](/modeling/develop/ai-optimization) to improve AI-generated query quality
* [Connect other AI integrations](/integrations/ai) to add external context
* [Review AI security practices](/ai/security) to understand how Omni processes data