Google Drive
Google Drive integration
Document ManagementAvailable
BRAIAN connects to Google Drive through Google Drive API, service account with domain-wide delegation scoped to specific folders. Agents can file retrieval, folder search and metadata read. Every action is scoped by the permissions granted to the integration and executed under a versioned policy. Each one is recorded in the audit log with the agent, timestamp and record touched.
What can BRAIAN do?
Agents retrieve files and read metadata from the folders a process is configured to cover. Delegation is scoped to those folders, so documents outside them remain out of reach.
| Capability | Agent | Read or write |
|---|---|---|
| File retrieval | LegalAgent | Read |
| Folder search | HRAgent | Read |
| Metadata read | LegalAgent | Read |
How does it connect?
- Connection method
- Google Drive API, service account with domain-wide delegation scoped to specific folders
- Credential
- A Google service account key held in the secrets store, with delegation limited to named folders.
Credentials are held in an encrypted secrets store. BRAIAN never stores end-user passwords.
Which permissions are required?
- drive.readonly (delegated)Read-only access to the delegated folders; no write scope is requested.
- drive.metadata.readonlyFile names, owners and modification dates used to locate the right document.
Permissions are requested at the minimum scope the configured processes require. Unused scopes are not granted.
Which processes use it?
Processes that run on this connection, and the domains they belong to.
Contract analysis
Employee onboarding
How do you revoke access?
Access is revoked in Google Drive itself — by disabling the credential or removing the granted scopes — or in BRAIAN by disconnecting the integration. Processes already running stop at their next call to Google Drive and are held for review rather than completed with partial data; the interruption and the state of each process are recorded in the audit log.
FAQ
Does BRAIAN store data from Google Drive?
BRAIAN reads what a process needs, when it needs it. Records retrieved from Google Drive are held only for the duration of the process and in the audit trail of the actions taken; Google Drive remains the system of record.
What happens if the connection fails mid-process?
The process stops at the failed step and is held for review. Nothing is written twice: completed writes stay recorded in the audit log and the remaining steps resume only once the connection is restored.
Can permissions be scoped per agent?
Yes. Scopes are defined per agent, not per system, so one agent can read while another cannot, on the same connection to Google Drive.
