Recommended methodThe recommended approach to creating a Google Drive Connection is to provision a user ruby-admin@yourdomain.com in your Google workspace and use that identity to connect Ruby to your various data sources. The IT/CISO/(name the right function here) will update Ruby data access using that account.
This will help them control what Ruby has access to by managing the permission of that account on Google Drive. The connection between Ruby and Google Drive is subject to the initial user’s permission. Any changes to a user’s Drive permissions could affect the data accessibility on Ruby. It’s crucial to manage permissions carefully to maintain a stable connection.
This will help them control what Ruby has access to by managing the permission of that account on Google Drive. The connection between Ruby and Google Drive is subject to the initial user’s permission. Any changes to a user’s Drive permissions could affect the data accessibility on Ruby. It’s crucial to manage permissions carefully to maintain a stable connection.
- Ruby and Google popups to authorize Ruby access to your Google workspace data.
- Google Authorization Acknowledgment
- Google Sign in modal
- Google Authorization modal
- A modal to select the exact data you want to sync with Ruby.
- Admins should either designate a single individual to manage Drive permissions for Ruby or utilize a virtual user (e.g., ruby@workspace.com) for consistent access management. This approach avoids unintentional permission resets and data disconnections.
- The email address used to manage permissions should have edition & download rights on the desired documents to allow them to be read by Ruby.
- Sometimes, downloads are blocked for specific documents. If you don’t see a document in your Gdrive Data Source tree, you can check that it is downloadable by following the path described in this toggle.
Converting Excels to Gsheets automatically
Ruby only syncs Google Sheets but is currently not compatible with Excel native format. For a file to be synced by Ruby and used in table queries, you need to convert it to GSheet. This can be done automatically in your GDrive settings if needed.\ If the Google Drive is very large, it is normal for the first synchronisation process to be quite long (over 24 hours, up to several days for extremely large Drives).- My synchronisation is taking longer than expected. What should I do?
Sync timesIf your Google Drive contains over c.50k files, the sync time can get long.
- Consider syncing only the part of your drive you want to use with Ruby.
- If you still have such a high number of files, do not hesitate to flag this to us so we can support the process the best way.
Refresh Rate
Data sync between Google Drive and Ruby can take a few minutes. Any additions or removals of data sources are not immediately reflected in Ruby.File Deletion Timeline
Google Drive’s deletion runs during the data sync process, which can take a few minutes.
Size limitations
There’s a file size limit of 128 MB for Google Spreadsheets and PDFs. Ruby supports up to 50,000 rows per Google sheet. If your spreadsheet has multiple sheets, each sheet is processed individually, so you can have up to 50,000 rows per sheet.OCR
The Google Drive connection in Ruby will ignore files that do not contain text (documents scanned as images for example).For such use cases, OCR can be achieved by directly uploading the pdf to a conversation
Labels
Labels on google drive items will be used as tags that you can use to filter documents in your agents.Custom labels support was added June 13 2025You need to reconnect your google drive (edit permissions) to allow fetching the labels. And update a document to have it re-synced.