Google Drive
Find, download, and upload files with least-privilege Drive access
Connect Google Drive when a project needs files from one shared account or from each published app user. Swarmz can create and use project files without requesting access to every existing file.
Available operations
| Operation | What it does | Permission | Limit per minute |
|---|---|---|---|
list_files | Finds one page of visible files | Search and view all Drive files | 60 |
download_file | Downloads one visible file by ID | Search and view all Drive files | 60 |
upload_file | Uploads one base64-encoded file, optionally into a folder | Create and use project files | 60 |
Create and use project files is selected by default. Select Search and view all Drive files only when the feature must discover existing files. Files the app creates remain available through the project-files permission.
Connect Google Drive
An administrator must configure the Google OAuth app and enable Google Drive under Admin > Settings > Integrations. Then ask the AI for the exact file workflow and name the account owner. Examples:
- “Upload generated invoices to our shared Drive folder.”
- “Let each signed-in user search and download files from their own Drive.”
Choose Connect new, select the required permissions, and authorize Google. For a published app-user connection, provide the app's final HTTPS origin and keep the generated gateway call in an authenticated server route.
Verify Google Drive
- Upload a small test file with a unique name.
- Confirm the file in Google Drive and record its file ID.
- If all-file read access was approved, find the file with
list_files. - Download it and compare its contents with the upload.
- Remove the test file in Google Drive.
If upload succeeds but search fails, the connection probably has project-files access only. Reconnect and approve all-file read access if the product requirement justifies it. Disconnecting does not remove provider files.
Generated browser code must not receive Google tokens, project gateway keys, or downloaded confidential files that the signed-in user is not authorized to view.