核心用法
gws-meet 是 Google Workspace CLI (gws) 的会议管理模块,封装 Google Meet REST API v2,提供命令行操作能力。支持两大核心资源:
conferenceRecords(会议记录)
get/list:获取会议详情与历史记录participants:管理与会者信息recordings/transcripts/smartNotes:访问录制文件、转录文本及智能笔记
spaces(会议空间)
create:创建新会议空间get/patch:查询与修改会议设置endActiveConference:强制结束进行中的会议
使用前需通过 gws schema meet.<resource>.<method> 探测参数结构,再组合 --params 或 --json 标志调用。
显著优点
- API 完整封装:覆盖 Meet v2 API 全部功能,包括企业级特性(智能笔记、转录)
- CLI 工作流整合:与
gws生态统一认证,支持脚本自动化与 CI/CD 集成 - Schema 自发现:内置
gws schema命令降低学习成本,无需反复查阅官方文档 - 细粒度权限:继承 Google Workspace 的 OAuth 2.0 权限模型,支持最小权限原则
潜在局限
- 依赖预配置:需先行完成
gws全局认证与权限授予,无法独立运行 - 企业版功能限制:智能笔记、高级录制等功能需 Google Workspace Enterprise/Enterprise Essentials 许可证
- 无实时会议控制:仅支持会后记录管理与空间配置,无法进行中的会议媒体流操作
- 版本耦合:
gws工具链版本需与 API 版本匹配,升级可能引入破坏性变更
适合人群
- Workspace 管理员需批量审计会议记录与合规归档
- 开发团队构建会议自动化工作流(如自动结束过期会议、提取转录)
- 安全运营中心(SOC)集成会议日志至 SIEM 系统
常规风险
- 数据泄露风险:
conferenceRecords包含敏感商务对话,需严格管控gws凭据存储 - 误操作会议终止:
endActiveConference为破坏性操作,生产环境建议加审批流程 - 权限蔓延:Meet API 需
admin.directory.resource.readonly等高级权限,定期审计 OAuth 授权范围