Gws Meet

核心用法

gws-meet 是 Google Workspace CLI (gws) 的会议管理技能，基于 Google Meet API 提供对会议空间、会议记录及子资源（参会者、录制、转录、智能笔记）的完整操作能力。

主要功能模块

会议空间管理 (`spaces`)

• create: 创建新的会议空间
• get/patch: 查看或修改会议空间详情
• endActiveConference: 强制结束进行中的会议

会议记录查询 (`conferenceRecords`)

• get/list: 获取或列出会议记录（默认按开始时间降序）
• 子资源操作：participants、recordings、transcripts、smartNotes

使用模式

# 基础调用结构
gws meet <resource> <method> [flags]

# 探索命令结构
gws meet --help
gws schema meet.spaces.get  # 查看参数规格

通过 gws schema 输出构建 --params 和 --json 参数，实现类型安全的 API 调用。

显著优点

• 官方 API 封装：直接对接 Google Meet REST API，数据权威可靠
• 统一 CLI 体验：与 gws 生态共享认证和全局标志，降低学习成本
• 细粒度资源控制：支持会议空间、录制、转录、参会者的独立操作
• 脚本化友好：适合 CI/CD 集成、批量会议管理、合规审计等自动化场景

潜在缺点与局限性

• 依赖 `gws` 主工具：必须安装并配置 gws CLI 及 OAuth/Service Account 认证
• API 权限要求：需 meet 相关 OAuth scope（如 meet.readonly 或 meet）
• 数据延迟：会议记录可能存在数分钟同步延迟
• 功能边界：仅支持 API 暴露的操作（如无法直接控制会议中的音视频设置）
• 无实时推送：需主动轮询获取会议状态更新

适合人群

• 企业 Workspace 管理员：批量管理会议空间、审计会议记录
• 开发者：构建会议自动化工作流（如会后自动分发录制）
• 合规团队：导出参会者日志、转录文本用于存档

常规风险

• 数据泄露风险：会议录制、转录含敏感信息，需确保存储和传输加密
• 权限过度授予：meet scope 可访问全组织会议数据，应遵循最小权限原则
• 误操作风险：endActiveConference 会强制终止进行中的会议，影响业务
• API 配额限制：高频调用可能触发 Google API 速率限制
• 认证凭证管理：Service Account 密钥需安全存储，避免代码仓库泄露