功能概述
gws-meet 是 Google Workspace CLI(gws)生态系统的子技能,专为企业级 Google Meet 会议管理提供命令行控制能力。该工具面向开发者和系统管理员,支持对会议空间(spaces)、会议记录(conferenceRecords)、录制文件(recordings)、智能笔记(smartNotes)及转录稿(transcripts)进行程序化操作。
核心用法
采用统一资源访问模式:gws meet <resource> <method> [flags]。主要资源包括:
- spaces:创建会议空间、获取/更新空间详情、强制结束活跃会议
- conferenceRecords:查询会议记录,支持按时间倒序筛选
- participants / recordings / transcripts / smartNotes:深度访问会议元数据与内容资产
关键命令范式依赖 gws schema meet.<resource>.<method> 预检机制,动态获取参数类型与必填项,降低 API 调用错误率。
显著优点
1. 企业级 API 完整封装:覆盖 Google Meet REST API v2 全功能集,包括会议生命周期管理与内容资产提取
2. 统一 CLI 体验:与 gws 其他子技能(gmail, calendar 等)保持一致的认证流与参数风格
3. 程序化批量操作:支持脚本化批量查询历史会议、自动导出转录与录制文件
4. 最小权限原则集成:继承 gws 的 OAuth 范围管理,可精确限定 meet.readonly 或细粒度范围
潜在局限与风险
- 认证门槛:强制依赖 Google Workspace 组织级 OAuth 应用配置,个人 Gmail 账户受限
- 版本依赖:v0.20.1 处于积极迭代期,API 行为可能随 Google 服务端更新而变动
- 无实时会议控制:不支持会议中的实时操作(如静音参与者、共享屏幕管理),仅限空间管理与事后记录处理
- 数据滞留合规:会议记录与录制文件的访问受组织数据保留策略约束,跨域查询可能失败
适合人群
- 需自动化会议资产归档的 DevOps/系统管理员
- 构建会议分析流水线的数据工程师
- 集成 Google Meet 数据至内部合规系统的安全团队
安全提示
该工具直接操作企业通信数据,需严格遵循最小权限 OAuth 范围配置,避免使用全域管理员账户执行自动化任务。