Google Drive

Allow Suger to manage your Google Drive seamlessly, including creating, deleting, updating, and sharing files and folders.

Overview

Google Drive is a versatile cloud storage and collaboration platform provided by Google. It offers users the ability to store, share, and collaborate on files and folders securely. With features like real-time editing, version history, and robust sharing options, Google Drive is a powerful tool for individuals and teams alike.

By integrating Suger with Google Drive, you can streamline document management processes, automate tasks such as file organization, access control, and notifications, enabling efficient workflow automation tailored to your specific needs.

Org-Level vs User-Level

Org-Level: Uses a service account for company-wide Google Drive access. Suitable when you need Suger to manage files across the organization’s shared Drive.
User-Level: Uses OAuth for personal Google Drive access. Suitable when each user needs to connect their own personal Drive account to Suger.

Create Integration (Org-Level)

Create a service account in your target GCP project for Google Drive integration.
Create the service account key, and download the associated JSON file.
Store the content of the key JSON file within the Suger console integration page.
Share files and folders in your Google Drive with the service account email address. If you want to grant Suger to create or update files, the service account needs to have necessary permissions.

Create User Integration

Use user-level integration when each user needs to connect their personal Google Drive account.

Click Connect Now button in the User Integrations section
You will be redirected to Google to authorize
Click Allow to grant Suger permission to access your Google Drive
Return to Suger to confirm connection
Verify the integration works

Suger AI Tools

Suger AI uses a middleware strategy — wrapping the Google Drive API directly.

Org-level and user-level: Both integration levels are supported. User-level takes precedence when both are connected.

Files

Tool	Description
`googledrive_get_about`	Get the authenticated user’s Drive account info and storage quota
`googledrive_search_files`	Search for files using Drive query syntax
`googledrive_list_recent_files`	List recently modified files
`googledrive_get_file_metadata`	Get metadata for a file (name, type, size, owner, web link)
`googledrive_read_file_content`	Read the text content of a file
`googledrive_create_file`	Create a new file (supports converting to Google Docs/Sheets/Slides)
`googledrive_create_folder`	Create a new folder
`googledrive_update_file_content`	Overwrite the contents of an existing file
`googledrive_update_file_metadata`	Rename, move, or update description of a file
`googledrive_copy_file`	Make a copy of an existing file
`googledrive_trash_file`	Move a file to Trash
`googledrive_untrash_file`	Restore a trashed file
`googledrive_list_shared_drives`	List shared drives (Team Drives)

Sharing & Permissions

Tool	Description
`googledrive_list_permissions`	List who has access to a file
`googledrive_share_file`	Share a file with a user, group, domain, or everyone
`googledrive_update_permission`	Change the role of an existing share
`googledrive_unshare_file`	Revoke a share

Comments & Replies

Tool	Description
`googledrive_list_comments`	List comments on a file
`googledrive_create_comment`	Add a comment to a file
`googledrive_update_comment`	Edit the text of an existing comment
`googledrive_delete_comment`	Delete a comment
`googledrive_list_replies`	List replies under a comment
`googledrive_create_reply`	Reply to a comment (supports resolve/reopen)
`googledrive_delete_reply`	Delete a reply

Revisions

Tool	Description
`googledrive_list_revisions`	List the version history of a file

Edit Integration

Editing an existing Google Drive integration is not supported. The practical way is to delete it and then re-create it from beginning.

Delete Integration

The Google Drive integration can be deleted like all other integrations. Once the deletion is triggered, all integration info including the service account with the key will be deleted immediately & permanently from Suger. No time window or methods to recover.