Table of contents
Google Calendar
Calendar gives reliable structure to the workday, showing scheduled commitments and how each person’s time is allocated. WorkSights ingests calendar metadata from Google’s audit logs, enriched with event details from the Calendar API.
For connection steps, see Connecting Google Workspace.
What WorkSights Receives
WorkSights processes two kinds of calendar activity.
Calendar interactions are user-driven actions on events: creating an event, changing its time, title, location, or attendees, and adding, removing, or responding to guesses. These appear as short entries in the Calendar Change category, reflecting quick calendar work rather than meeting time.
Calendar events are the scheduled events themselves, appearing as time blocks with the event’s real start, end, and duration. Event descriptions and attachments are never received.
How Calendar Activity Appears
WorkSights classifies each event by its participants, ignoring rooms and equipment:
- An event with one or fewer relevant participants is a Calendar Block, used for focus or personal time
- An event with two or more participants who are all WorkSights users is a Meeting (Internal)
- An event with two or more participants where any is external is a Meeting (External)
Each type is color-coded differently. Because the rule is re-evaluated on every change, adding or removing a guest can move an event between categories on its next update.
Meeting duration comes from the event’s scheduled start and end times. Events longer than ten hours are excluded from scoring, as they usually represent out-of-office or personal blocks. Calendar blocks are visible on the timeline but not scored.
Meeting duration comes from the event’s scheduled start and end times. Events longer than ten hours are excluded from scoring, as they usually represent out-of-office or personal blocks. Calendar blocks are visible on the timeline but are not scored.
A single event can appear on the organizer’s, the actor’s, and the calendar owner’s timelines, since the block is written for each of them.
Troubleshooting
Calendar activity is not appearing
Confirm the domain is connected and Calendar is enabled in the Features tab. Confirm the affected user is mapped and has a role assigned.
A meeting shows as Internal but had a client on it, or the reverse
The category is based on whether attendee emails resolve to WorkSights users, and it re-evaluates when guests change. Check the attendee list on the event. Adding or removing guests flips the category on the next update.
Activity appears late
This is expected. Calendar activity is processed in batches roughly every 10 to 15 minutes.