
Table of contents
Google Workspace Integration Overview
Google Workspace is the broadest WorkSights integration. A single org-level connection made by a Workspace admin covers the entire domain, bringing Calendar, Drive, Meet, Chat, and Login activity into the timeline, plus optional outgoing email metadata through a separate forwarding rule.
Activity comes from Google's Admin audit logs and appears within about 10 minutes. No document contents, chat text, email bodies, or recordings are ever received.
For connection steps, see Connecting Google Workspace.
What WorkSights Receives
WorkSights receives event-level metadata from several Google Workspace services. No document contents, chat text, email bodies, or sensitive payloads are ever stored.
Directory
WorkSights imports users from the Google Workspace domain and keeps the list current as people join. This drives user mapping across every Google service.
Calendar
Event details, timestamps, attendee lists, event changes, and RSVP actions. Calendar data lets WorkSights categorize time into meetings and focus blocks.
Drive
Notifications when a user views, edits, creates, renames, moves, shares, downloads, or comments on a file. Only file titles and action types are received, never document contents.
Meet
Call start and end times and each participant's real attendance duration, recorded when a call ends.
Chat
Metadata about messages, rooms, and threads. Message content is never received.
Login
Authentication events, including successful logins, failed attempts, and login challenges, with network and region information.
Email (Optional)
If your domain's forwarding rule is configured, WorkSights receives outgoing email header metadata: subject, participants, and attachment names, never the body. See the Gmail Forwarding guide for setup.
How It Appears in WorkSights
Calendar events are categorized by their participants. Rooms and equipment are dropped first. An event with one or fewer remaining participants is a Calendar Block, used for focus time. An event where every participant is mapped to a WorkSights user is a Meeting (Internal). An event with any unmapped participant is a Meeting (External). The category is re-evaluated whenever guests change, so adding an external guest can flip a meeting from internal to external. Activities of 10 hours or more are not scored or displayed, for every activity type.
Because a meeting is written for the organizer, the actor, and the calendar owner, the same meeting can appear on several people's timelines, provided each has an active subscription.
Meet calls appear once per participant, each reflecting that person's real attendance time rather than the scheduled slot. Calls appear after they end, not while in progress.
Drive activity appears with the file title and action. Repeated edits to the same file within a working session are consolidated into a single block reflecting the real working period, rather than one entry per notification.
Chat activity appears in the Chat category. Titles show the action and, when available, the room name. Related conversation activity can be grouped into a session, so an entry does not always represent a single message. See Google Chat for title examples. Login events appear as short entries marking each authentication.
Integration Page Overview
The Google Workspace integration page has Overview, Users, Features (controls for Calendar, Drive, Meet, Chat, and Email) and Connections tabs. See Connected Services and Service Details for how these tabs work.

Data Notes
WorkSights receives metadata only. Email content, document contents, chat text, audio, video, recordings, and transcripts are never received or stored.
Google generates some system-level events overnight, such as automated room additions. WorkSights identifies and suppresses these so timelines stay accurate. Working-location calendar events are ignored entirely.
For Drive, Chat, and Meet, activity from someone who resolves to a known client contact rather than a mapped user is stored as client-authored activity on ClientSights. This gives relationship context without affecting activity estimates.
Domain Rules
Each Google Workspace domain connects once. Organizations managing multiple domains can add each separately. Duplicate connections to the same domain are blocked to prevent redundant processing.
Troubleshooting
No activity after connecting
Confirm the provisioning wizard was completed and the affected user is mapped to a WorkSights user with an active feature subscription for the relevant service. Unmapped actors are skipped.
Activity stopped for everyone at once
The admin token may have been revoked, for example if the connecting admin left, reset their password, or withdrew consent. This stops all Google activity together. Have a Workspace admin reconnect Google.
Activity stopped for one service only
The notification channel for that service may have expired without renewing. The next processing cycle repairs the gap. If it persists, reconnecting refreshes all channels. Contact us at [email protected] for assistance.
A meeting appears on several people's timelines
This is expected. A meeting is written for the organizer, the actor, and the calendar owner, each of whom has an active subscription.
Activity appears late
This is expected. Activity appears within about 10 minutes.
A non-admin tried to connect
Google's directory and audit scopes require an admin account. Reconnect with a Google Workspace admin.