核心用法
gws-meet 是 Google Workspace CLI (gws) 的子技能,用于程序化操作 Google Meet API v2。主要覆盖两大资源维度:
会议空间管理(spaces)
create— 创建会议空间,支持自定义空间名称、权限配置get/patch— 查询与更新空间详情endActiveConference— 强制结束进行中的会议,适用于超时清理或运维干预
会议记录管理(conferenceRecords)
get/list— 获取单条或批量查询会议记录(默认按开始时间降序)participants— 导出参与者名单与参会时长recordings/transcripts/smartNotes— 提取录制文件、转录文本及智能摘要
显著优点
- 原生集成 Google Workspace 生态:直接调用官方 API,数据合规性有保障
- 细粒度资源操作:支持按会议 ID 精准获取录制、转录等敏感数据
- 运维友好:
endActiveConference提供程序化手段管理失控会议
潜在缺点与局限性
- 前置依赖重:必须预装
gws主程序并配置 OAuth2/服务账号认证,门槛较高 - API 配额限制:Google Meet API 存在每日调用上限,大规模企业需申请提升配额
- 录制文件延迟:录制与转录生成通常有 10-30 分钟延迟,非实时可用
- 区域可用性:部分功能(如 smartNotes)受 Google Workspace 订阅版本与地区限制
适合人群
- 企业 IT 管理员需批量审计会议记录
- 开发者构建会议数据归档、合规留存系统
- 教育/医疗行业需自动化提取转录用于后续分析
常规风险
- OAuth 权限泄露:
gws-meet需meet.readonly或meet权限范围,令牌泄露可导致会议数据暴露 - 误操作终止会议:
endActiveConference为破坏性操作,无二次确认机制 - 数据驻留合规:录制文件存储位置受 Google Workspace 数据区域策略约束,跨境企业需确认合规