Skip to main content

Google Drive

Connect a Google account so assistants can browse, search and read files in that Drive and its shared drives — and, when you allow it, create, organize, copy and edit files and Google Docs, and save copies into Gravity Rail Files. Google Drive is a per-member connection: each workspace member connects their own Google account. Workspace admins enable the feature; members authorize their own OAuth grants.

This is separate from files you upload into Gravity Rail. Drive stays in Google; assistants search it at request time. Nothing is copied into Gravity Rail unless you ask an assistant to save a copy into Files (see Saving a Copy to Files) or to read a file and work with its contents.

Before You Start​

You'll need:

  1. The Google Drive feature enabled on your workspace. If your plan includes it, a workspace admin can ask the Manager to set it up, or turn it on in Settings. If you don't see Google Drive in the App Connections directory, ask your Gravity Rail administrator.
  2. A Google account with access to the files you want assistants to find. You can connect more than one Google account if you work across several organizations.
  3. If the account is on Google Workspace, a domain admin must allow Gravity Rail first. Personal @gmail.com accounts do not need this. See Google Workspace Accounts.

Connecting Your Google Account​

  1. Go to App Connections and open the Directory tab.
  2. Find Google Drive (under Documents) and click Add, then confirm Add.
  3. Click Connect — you'll be redirected to Google's authorization page.
  4. Sign in with the Google account whose Drive you want assistants to search.
  5. Review and approve the requested permissions (see Required Permissions below).
  6. You'll be redirected back to your workspace. The new connection appears on the Active tab under Enabled.

Connecting Multiple Google Accounts​

  1. On the Active tab, open the Google Drive connection.
  2. Click Add account and repeat the OAuth flow with the second account.
  3. Assistants see all connected accounts when listing available connections.

Connecting During a Chat​

In a Manager Chat, ask the Manager for a Drive file, for example "Find the care plan for this patient in our Insurance folder". If Drive is not set up yet, the Manager sets it up with you: it turns on the app connection (with your approval, if you are an admin), then shows a Google Drive card with a Connect button. Approve Google's consent screen, and the Manager continues.

In other chats, if the workspace has inline connect enabled and you don't yet have a Google Drive connection, an assistant may prompt you to connect the same way.

Required Permissions​

Gravity Rail requests the following Google OAuth scopes when you connect:

ScopeWhy it's needed
driveFind, read, organize and copy files the connected account can already open, including shared drives
documentsEdit an existing Google Doc when you ask
userinfo.email, userinfo.profile, openidIdentify which Google account is connected

The assistant's tools follow the Drive ability's access mode in Gravity Rail. A read-only ability cannot create, move or edit Drive files. In a Manager Chat, every change asks for your approval first. An Agent asks for approval before it creates a file, edits a Doc, or moves or copies a file.

If you connected Drive before these permissions were added, assistants can still read your files. To create, organize or edit them, reconnect the account once (an assistant will tell you when).

What Assistants Can Do​

Once your Google account is connected, assistants with the integration:google_drive ability can:

ToolWhat it does
List connectionsShow which Google accounts you have connected
Find a folder pathFollow a path like Insurance/Aetna/2026 folder by folder, including shared drives
List Drive filesList a folder's contents by date or name, or search by name, content, or file type across My Drive and shared drives
File detailsShow a file's full folder path, when it last changed and who last changed it
Read a fileRead Google Docs, Sheets and Slides, PDFs, Word, Excel and text files; long files are read in pages
Read a scanned documentMake a text-readable Google Doc copy of a scanned PDF or image (read-write)
Read a Google DocRead a Doc with its headings, lists, tables and tabs
Create a file or folderCreate a Google Doc, a text file or a folder (read-write)
Move, rename or copyMove a file into another folder, rename it, or copy it (read-write)
Edit a Google DocAdd, insert, replace or delete text, or add a heading (read-write)
Save a copy to FilesCopy a Drive file into a Gravity Rail folder. Google Docs, Sheets and Slides are saved as PDF, or as text (a Sheet as CSV) when you ask (read-write)
Reconnect accountRe-authorize a connected account if the token has expired

Assistants can only see files the connected Google account can already open — including files shared with that account. Assistants cannot delete, trash or share files; they give you the link to do that in Drive.

Saving a Copy to Files​

Ask the assistant to save the file and say which folder it goes in, for example "Save this patient's care plan from Drive to Patients/Care plans." The assistant asks for your approval first. Then:

  • It saves a new File. It never replaces a File: if the name is taken, the copy is saved as Care plan (2).pdf.
  • Everyone who can already open that folder can open the copy, and no one outside it. If those people could not see this document before, they can now — so choose a folder whose audience may see it.
  • A Google Doc, Sheet or Slides deck is saved as a PDF by default. Ask for text to get a .txt file (a Sheet's first tab as .csv).
  • Other files are copied as they are, if they are a type you can upload yourself and no larger than 25 MB. Folders, shortcuts and Google Forms cannot be saved.
  • In a Workflow, the assistant can save only into a folder the Workflow's Files ability lets it create in.

The copy in Files does not change when the Drive file changes.

Managing Your Connection​

Viewing Connected Accounts​

Go to App Connections → Active tab and open Google Drive. Each row shows the connected Google email address and connection status.

Reconnecting an Expired Account​

If your OAuth token expires or is revoked, the connection shows a Reauthorize Required badge:

  1. Open the Google Drive connection on the Active tab.
  2. Click Reauthorize next to the affected account.
  3. Complete the Google OAuth flow again.

Alternatively, ask an assistant to reconnect: "Reconnect my Google Drive account."

Removing an Account​

  1. Open the Google Drive connection on the Active tab.
  2. Click the action menu next to the account you want to remove.
  3. Choose Disconnect.

To remove the integration entirely, choose Delete app from the connection's action menu. This removes all connected Google accounts and their stored tokens.

Also revoke from Google. Removing the connection in Gravity Rail deletes our copy of the OAuth token, but Google keeps its own record of the grant. To fully revoke access, visit myaccount.google.com/permissions and remove the Gravity Rail app.

Troubleshooting​

"This app is blocked" or admin_policy_enforced​

The Google account is on a Workspace domain that blocks unverified third-party apps. Send Google Workspace Accounts to your Google Workspace admin and retry after they mark the Drive client as Trusted.

"Reauthorize Required" badge​

Google has revoked or expired the access token. This happens when:

  • The token hasn't been used for six months (Google's inactivity policy)
  • You changed your Google account password
  • You manually revoked access in Google's account settings
  • An admin in your Google organization restricted third-party app access

Open the connection and click Reauthorize to re-run OAuth.

Assistant can't find a file​

  • Confirm the file is accessible to the Google account you connected.
  • Try a more specific name or phrase in your prompt.
  • Give the folder path, for example "Insurance › Aetna › 2026". The assistant follows it folder by folder and lists what it finds when a name doesn't match.
  • A file shared with you in the last minute may not appear in Drive search yet.

Assistant says a file is a scan​

Scanned PDFs and photos have no text to read. Allow read-write access and ask the assistant to make a readable copy. It saves an OCR'd Google Doc copy next to the original.

"Google Drive not available" or missing from the Directory​

The Drive feature is not enabled on your workspace. Ask your Gravity Rail administrator to enable it.