Connect a service account
1
Create a service account
In Google Cloud Console, create a service account in a project with the Google Drive API enabled. Download its JSON key file.
2
Connect in Ravenna
Go to Settings > Integrations, open Google Drive and choose Connect with Service Account. Enter the service account credentials from the JSON key file. Ravenna checks the credentials with Google before saving.
3
Share files with the service account
Share the folders and files Ravenna should work with to the service account’s email address. Ravenna only sees what is shared with it. To share or unshare a file, the service account needs Editor access to it.
One Google Drive service account connects per organization. Every workspace in the organization uses it.
Workflow actions
Add these actions from the Google Drive app in the workflow builder.
Users accepts people and user groups. Ravenna expands groups to their members and uses each person’s email address.
Agent tools
Reference these tools in agent rules with @ mentions.When someone asks for access to a team document, find it with @Search Google Drive Files using the document name, confirm the right file with the requester, then run @Share Google Drive File with their email and role reader.
How it works
File URLs
File URLs
Share and unshare take the file’s link, such as
https://docs.google.com/document/d/FILE_ID/edit or https://drive.google.com/file/d/FILE_ID/view. Ravenna reads the file ID from the /d/ part. A link without it fails with an invalid file URL error.Search scope
Search scope
Search covers every file shared with the service account, including shared drives it belongs to. Trashed files are left out. When an agent search reaches its limit, the result says so and the agent can add filters to narrow it.
What unsharing removes
What unsharing removes
Unshare removes access granted directly on the file. People with no direct access are skipped. Access inherited from a shared folder and the file owner’s access stay in place.
Notification emails
Notification emails
Google emails each person a file is shared with unless you turn Send Notification Email off in the workflow action, or the agent sets
send_notification to false.Learn more about workflows and configuring agents