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:
- 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.
- 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.
- If the account is on Google Workspace, a domain admin must allow Gravity Rail first. Personal
@gmail.comaccounts do not need this. See Google Workspace Accounts.
Connecting Your Google Account
- Go to App Connections and open the Directory tab.
- Find Google Drive (under Documents) and click Add, then confirm Add.
- Click Connect — you'll be redirected to Google's authorization page.
- Sign in with the Google account whose Drive you want assistants to search.
- Review and approve the requested permissions (see Required Permissions below).
- You'll be redirected back to your workspace. The new connection appears on the Active tab under Enabled.
Connecting Multiple Google Accounts
- On the Active tab, open the Google Drive connection.
- Click Add account and repeat the OAuth flow with the second account.
- 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:
| Scope | Why it's needed |
|---|---|
drive | Find, read, organize and copy files the connected account can already open, including shared drives |
documents | Edit an existing Google Doc when you ask |
userinfo.email, userinfo.profile, openid | Identify 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:
| Tool | What it does |
|---|---|
| List connections | Show which Google accounts you have connected |
| Find a folder path | Follow a path like Insurance/Aetna/2026 folder by folder, including shared drives |
| List Drive files | List a folder's contents by date or name, or search by name, content, or file type across My Drive and shared drives |
| File details | Show a file's full folder path, when it last changed and who last changed it |
| Read a file | Read Google Docs, Sheets and Slides, PDFs, Word, Excel and text files; long files are read in pages |
| Read a scanned document | Make a text-readable Google Doc copy of a scanned PDF or image (read-write) |
| Read a Google Doc | Read a Doc with its headings, lists, tables and tabs |
| Create a file or folder | Create a Google Doc, a text file or a folder (read-write) |
| Move, rename or copy | Move a file into another folder, rename it, or copy it (read-write) |
| Edit a Google Doc | Add, insert, replace or delete text, or add a heading (read-write) |
| Save a copy to Files | Copy 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 account | Re-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
.txtfile (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:
- Open the Google Drive connection on the Active tab.
- Click Reauthorize next to the affected account.
- Complete the Google OAuth flow again.
Alternatively, ask an assistant to reconnect: "Reconnect my Google Drive account."
Removing an Account
- Open the Google Drive connection on the Active tab.
- Click the action menu next to the account you want to remove.
- 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.
Related
- Google Workspace Accounts — Allow Drive on a company Google domain
- Google Sheets — Find and edit spreadsheets
- File Browser and File Editor — Files stored in Gravity Rail
- App Connections — Overview of the integration hub
- Abilities — How assistant abilities and toolkit permissions work