Last updated
November 10th, 2026

Google Calendar

Calendar shows scheduled commitments and how each person's time is allocated. WorkSights receives 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 invitations. 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. They appear as time blocks with the event's real start, end, and duration. Event descriptions and attachments are never received.

How It Appears in WorkSights

WorkSights categorizes each event by its participants. Rooms and equipment are dropped first:

  • An event with one or fewer remaining participants is a Calendar Block, used for focus or personal 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)

Each type is color-coded differently. The rule runs again on every change, so 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. Activities of 10 hours or more are not scored or displayed, for every activity type, since 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 depends on whether attendee emails resolve to WorkSights users, and it runs again 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 appears within about 10 minutes.

Related Guides

Google Workspace Overview

Connecting Google Workspace

Google Meet