Google Drive
Google Drive
Google Drive: Overview and capabilities
Integrate Atomicwork with Google Drive to enable seamless file sync and enterprise search on your enterprise knowledge graph. Once connected, your Assistant can access and learn from the documents you specify, so your employees can get quick and accurate answers on that information without switching between multiple platforms.
Here are the key features and capabilities you can unlock with the Atomicwork-Google Drive integration:
- Connect files and folders for the Assistant to learn: Workspace admins can add Google Drive folders as knowledge in their workspaces. All files, including those within subfolders, are indexed automatically for easy search and access.
- Inherit Google Drive permissions: Employees can only access files that they have permissions for in Google Drive. Any changes in Google Drive permissions reflect automatically in Atomicwork.
- Sync content regularly: Atomicowrk automatically syncs with Google Drive every 24 hours to reflect any changes in connected documents. You can add or remove files and folders, re-index, or even disconnect at any time to manage your data.
- Find information easily: Employees can search for information in Google Drive files and even filter or analyze structured data, directly through Atom.
Google Drive: Permissions and setup
Permissions
To connect your Atomicwork and Google Drive accounts, you need:
- Atomicwork admin access: You need org admin access in Atomicwork.
- Google Drive admin access: You need to be an admin for the Google Drive account, allowing you to manage permissions.
Atomicwork requires specific Google Workspace permissions to function properly, including:
- drive.readonly: Access to your Google Drive files to read and download documents
- admin.directory.group.readonly: Visibility into who files are shared with (e.g., users or groups)
- admin.directory.group.member.readonly: Access to group details (such as members, roles, and metadata) to accurately map file sharing and ownership across your organization
Roles
- Org admins are responsible for integrating Google Drive with Atomicwork.
- Workspace admins can connect Google Drive folders/files from shared drives to configure workspace topics. They can control employee download permissions but cannot modify file access, as Google Drive remains the source of truth.
- End-users will be able to search for and access only files they have permissions for in Google Drive.
Setup
- As an Atomicwork admin, navigate to Settings > App Store > Google Drive, and click on Connect. You will be redirected to Google's authentication page.
- Sign in with the Google Drive admin account and grant the necessary permissions.
- Once authenticated, you will be redirected back to Atomicwork with a confirmation message.
Disconnecting your Google Drive account
- Navigate to Settings > App Store > Google Drive.
- Click Disconnect and confirm the action in the pop-up dialog.
- Once disconnected, employees will no longer be able to search for or access Google Drive files in Atomicwork.
Google Drive: Adding files for the Assistant to learn
Workspace admins can add Google Drive files and folders as knowledge in their workspace, making it easier for employees to find and access the information they need.
Adding a Google Drive folder to a knowledge allows the Assistant to learn from all its files, including those in subfolders.
Permissions are inherited directly from Google Drive, ensuring users can only access content they are authorized to view. They cannot be modified in Atomicwork.
Adding Google Drive files to knowledge
The Assistant can only learn from files in shared drives in Google Drive.
To add a Google Drive folder to a knowledge:
- Navigate to Settings > Your workspace. Click on Knowledge under the Deflection and automation section.
- Open the knowledge to which you would like to sync Google Drive files or click on Add to create a new knowledge.
- Click on Add at the top right and select Google Drive.
- Choose the desired folder from Google Drive. You can add the entire folder or navigate to individual files to add them.
- If a folder is selected to be uploaded, all files within that folder as well as subfolders are added.
- Supported file types include DOCX, PDF, PPTX, CSV, XLSX, TXT, MD, Google Docs, Slides, and Sheets. Media files such as PNG, JPG, and MP4 are not currently supported.
Syncing Google Drive changes to Atomicwork
Once integrated, Atomicwork syncs with Google Drive every 24 hours to reflect changes in connected documents, including new files, removals, and permission updates. You can also sync manually anytime to keep your data up to date.
Syncing file changes
- Deleted files in Google Drive are removed from Atomicwork on the next sync.
- Renamed files update automatically in Atomicwork after syncing.
- New files in an already synced folder aren’t uploaded automatically; you will have to run a manual sync to add them immediately.
- Moving a file to another folder in Google Drive treats it as deleted in the original folder; it will sync from the new folder, if added.
Syncing user permissions
- You can allow or restrict file downloads in Atomicwork, but you cannot change file permissions; Google Drive remains the source of truth for permissions.
- If a user is added or removed from a file's access list, this will be reflected in Atomicwork with the next sync. For immediate updates, you can choose to **Sync now.**