用途
该配方用于查询多个用户的 Google Calendar 空闲/忙碌(free/busy)状态,从而在多个日历之间找到可用的会议时段。
前置条件
执行本配方前,需先加载以下技能:
- gws-calendar
使用方式
1. 查询空闲/忙碌状态
使用 gws calendar freebusy query 命令,指定查询时间范围与需要查询的日历列表。示例:
gws calendar freebusy query --json '{"timeMin": "2026-04-07T08:00:00Z", "timeMax": "2026-04-07T18:00:00Z", "items": [{"id": "user1@company.com"}, {"id": "user2@company.com"}]}'
2. 查看输出,寻找重叠的空闲时段
检查上一步命令的输出,找出多个日历共同空闲的重叠时段。
3. 在空闲时段创建事件
使用 gws calendar +insert 命令,在选定的空闲时段创建会议事件并添加参会者。示例:
gws calendar +insert --summary 'Meeting' --attendee user1@company.com --attendee user2@company.com --start '2026-04-07T14:00:00-05:00' --end '2026-04-07T14:30:00-05:00'
适用场景
- 需要为多位参会者协调会议时间时
- 需要跨多个日历查找共同可用时段时
限制
关于该配方支持的用户数量上限、时区处理方式、冲突或错误处理机制、权限要求等,暂未提供更多说明。