Feature request: Appointment Schedule support

[willgdjones]

Hey! Love this tool - it's become part of my daily workflow.

I've been using Google Calendar's Appointment Schedules (the bookable scheduling pages) and would love to manage them from gog. My main use case is updating my "Adjusted availability" each week - right now I have to go into the web UI every time.

I know this isn't fully supported in the official Calendar API yet - appointment schedules are stored as events with eventType: "appointmentSchedule" and you can list them with the eventTypes filter, but the schedule properties themselves aren't properly documented. So this might be a tricky one.

Even partial support would be great though:

1. gog calendar appointment-schedules list - see what schedules exist
2. gog calendar appointment-schedules set-availability --date 2026-02-24 --from 10:30 --to 15:00 - override availability for a specific date
3. gog calendar appointment-schedules clear-availability --date 2026-02-24 - remove an override

Happy to help test if you want to explore this. No worries if it's too undocumented to be worth it right now - just wanted to flag the interest!

[steipete]

Closing as an upstream Google Calendar API limitation, not a local implementation gap.

Verified today with clawdbot: Events.list(...).EventTypes("appointmentSchedule") returns 400 invalidParameter and says allowed values are birthday, default, focusTime, fromGmail, outOfOffice, and workingLocation.

Official Calendar docs still list event-type support around those exposed event types, with no appointment schedule event type available for list/read:

• https://developers.google.com/workspace/calendar/api/guides/event-types
• https://developers.google.com/calendar/api/v3/reference/events/list

The CLI keeps gog calendar appointments as an explicit diagnostic explaining the unsupported API surface. Changelog/spec/docs are updated in 1faed6b.