核心用法
gws-meet 是 Google Workspace CLI (gws) 的会议管理子命令,封装 Google Meet REST API v2,提供会议空间生命周期管理与会议记录检索能力。
主要资源操作:
- spaces: 创建会议空间、获取/更新空间详情、强制结束活跃会议
- conferenceRecords: 查询会议记录(按开始时间降序)、获取单条记录详情
- 子资源操作: 通过
.链式访问 participants、recordings、smartNotes、transcripts
典型工作流:
# 创建会议空间 gws meet spaces create --params 'name=团队周会' # 获取会议记录 gws meet conferenceRecords list --params 'pageSize=10' # 获取转录文本 gws meet conferenceRecords.transcripts list --params 'parent=conferenceRecords/XXX'
显著优点
1. 统一 CLI 体验: 与 gws 生态一致,共享认证与配置体系
2. API 完整覆盖: 支持 Meet v2 API 全部核心能力,包括新推出的 Smart Notes
3. 结构化探索: gws schema 命令可自省 API 参数类型与必填项,降低学习成本
4. 自动化友好: 适合 CI/CD 集成、批量会议记录归档、合规审计等场景
潜在缺点与局限性
- 依赖外部工具: 必须预先安装
gws二进制并配置 Workspace 认证 - 权限门槛: 需要 Google Workspace 管理员授权或特定 OAuth 范围
- 无实时功能: 仅支持会后数据处理,无法进行中的会议实时管理(除结束会议外)
- 区域限制: 部分功能(如 Smart Notes)受 Google 服务可用区域限制
适合人群
- Workspace 管理员进行会议合规与审计
- 开发团队构建会议自动化工作流
- 需要将会议数据(转录、录制)同步至内部系统的集成工程师
常规风险
- 数据泄露风险: conferenceRecords 包含敏感会议元数据,需严格控制访问范围
- 误操作风险:
endActiveConference会强制终止进行中的会议,缺乏二次确认机制 - OAuth 令牌管理: 需遵循
gws-shared安全规范,避免长期凭证硬编码