Use cases → Scheduling
Report on calendar availability across users in a domain
A delegated service account queries multiple calendars to produce a report of who is free or busy over a given window.
| Who it is for | Resource coordinators or central scheduling teams needing to scan availability across many calendars at once. |
|---|---|
| APIs | Calendar API |
| Typical scopes | calendar.readonly |
The problem
Arranging meetings or coverage across a team means checking everyone's calendar, but Google Calendar's UI and sharing model make it awkward to view dozens at once. Manual checks are error-prone, and exporting data is tedious.
How it works
- A service account, with domain-wide delegation, impersonates each user and fetches their primary calendar events for the reporting window.
- The automation parses events, handling recurring and all-day entries, to build a per-user free/busy timeline.
- It aggregates everyone’s availability and outputs a report—CSV, spreadsheet, or dashboard—showing who is free, busy, or tentative.
- Edge cases (private events, out-of-office, secondary calendars) are marked in the report.
- The process is run on demand or scheduled as needed.
What changes
Coordinators get a reliable, up-to-date snapshot of team availability without opening dozens of calendars by hand.
Questions people ask
Does this require users to share their calendars?
No. Domain-wide delegation allows the service account to read everyone's primary calendar, regardless of their sharing settings.
Can it include secondary calendars or shared resources?
Yes, but you must explicitly enumerate those calendars—the default is only the user's primary calendar. Resource calendars can be queried if their IDs are known.
Want this built?
This is a pattern we run in production. We will set up the delegation and build this on top of it — $500 per hour, most of it working the same day.
Talk to us Or read the setup guideRelated use cases
Build a real picture of team availability
Read calendars across the domain to answer who is free, who is overloaded and where the week actually went.
Turn a finished meeting into follow-up automatically
Detect that a meeting happened, pull the notes, and draft the follow-up before anyone opens their laptop.
Turn a booking into a record everywhere it matters
When a meeting is booked, create the record, the folder and the confirmation in one pass.