Table of contents
Connecting Google Workspace
For the WorkSights signup steps, see Sign Up with Google Workspace.
Step 1: Start the Connection
Go to Services in the top navigation, find Google Workspace, and click Connect.
Step 2: Authorize as a Workspace Admin
Sign in as a Google Workspace admin and grant the requested read-only permissions. The directory and audit scopes only work for admin accounts, so a non-admin authorization will fail.
WorkSights requests three read-only permission groups:
- Directory access, to keep the WorkSights user list aligned with your domain
- Calendar metadata access, to read event details, times, and attendees
- Audit event access, to receive activity from Calendar, Drive, Meet, Chat, and Login
Step 3: Complete the Provisioning Wizard
After authorizing, you land in the provisioning wizard. Choose which features to enable (Calendar, Drive, Chat, Meet, Email), map the imported directory users, assign roles, and assign managers. Only mapped users with an active feature subscription generate activity.
What Happens Next
On connect, WorkSights registers activity channels and imports the last 30 days of activity for the provisioned users, so timelines are populated from day one. Ongoing activity appears within roughly 10 to 15 minutes.
The user directory stays current automatically through directory-change updates and a daily sync. Feature settings and user mappings can be reviewed and updated at any time from the integration page.
For longer historical windows, we can run a manual import going back up to roughly 126 days, the limit of Google’s audit retention. Contact us at success@worksights.ai for more information.