Zoom Calendar

核心用法

该技能通过命令行脚本 zoom_meeting.sh 实现 Zoom 与 Google Calendar 的深度集成。用户只需提供日历事件 ID、会议标题、开始时间和时长，即可自动完成以下操作：

1. 调用 Zoom Server-to-Server OAuth API 创建会议室
2. 将生成的会议信息（加入链接、会议号、密码）以标准 conferenceData 格式写入 Google Calendar 事件
3. 自动设置官方 Zoom 图标、视频入口点和结构化备注

典型工作流程：

• 先用 gog calendar create 创建日历事件
• 执行脚本绑定 Zoom 会议
• 日历事件即刻显示带图标的视频入口，与 Zoom for Google Workspace 插件效果一致

显著优点

• 官方级集成体验：使用 Zoom Marketplace 官方图标 URL，生成的日历事件外观与官方插件无异
• 零手动操作：告别复制粘贴会议链接，全部字段自动填充
• 标准化数据格式：严格遵循 Google Calendar conferenceData 规范，确保跨客户端兼容性
• Server-to-Server 架构：无需个人 Zoom 登录，适合自动化场景和团队协作

潜在缺点与局限性

• 依赖特定工具链：强制依赖 gog CLI 进行 Google Calendar 认证，若该工具不可用则无法运行
• 时区硬编码限制：当前版本默认使用 Jerusalem 时区，跨时区团队需额外注意
• OAuth 配置门槛：需要手动在 Zoom Marketplace 创建 Server-to-Server OAuth 应用并配置权限范围
• 环境变量依赖：需要预置 GOG_KEYRING_PASSWORD 和 GOG_ACCOUNT，密钥管理不当可能引发泄露风险
• 无冲突检测机制：不会检查日历事件是否已有其他会议系统（如 Google Meet、Teams）的 conferenceData

适合人群

• 需要批量创建带 Zoom 会议的日历活动的行政助理或团队运营人员
• 希望自动化会议安排流程的开发者或技术团队
• 使用 gog 工具链且已配置 Zoom Server-to-Server OAuth 的企业用户

常规风险

• 凭证泄露风险：.credentials/zoom.json 包含高权限 OAuth 凭证，需严格限制文件权限
• 权限过大：meeting:write:admin 和 meeting:read:admin 为管理员级别权限，建议创建专用 Zoom 子账户
• API 配额限制：Zoom API 存在调用频率限制，高频使用需监控配额
• 日历数据覆盖：脚本会直接修改现有事件，误操作可能导致原有会议信息丢失