核心用法
本 Skill 提供对 Google Meet REST API 的代理访问能力,通过 Maton 平台托管 OAuth 认证,用户仅需配置 MATON_API_KEY 环境变量即可调用完整的 Google Meet API 功能。
主要功能模块:
- 会议空间管理:创建持久化的会议空间(Spaces)、获取/更新空间配置、结束活跃会议
- 会议记录查询:获取历史会议的 Conference Records,支持按空间过滤
- 参与者管理:列出会议参与者、获取详细信息及会话记录
- 录制与转录:访问会议录制文件和实时转录文本(需 Google Workspace 订阅)
接入流程:
1. 在 maton.ai 注册并获取 API Key
2. 创建 Google Meet OAuth 连接并完成浏览器授权
3. 使用标准 HTTP 客户端(Python urllib、requests、curl 等)调用 https://api.maton.ai/google-meet/v2/ 下的原生 API 路径
显著优点
- 零 OAuth 开发成本:Maton 全权托管 Google OAuth 令牌刷新与存储,开发者无需处理复杂的 OAuth 2.0 流程
- 原生 API 透传:直接映射 Google Meet API 路径,响应格式与官方文档完全一致,无学习成本
- 多账户支持:通过
Maton-ConnectionHeader 可在同一 API Key 下管理多个 Google 账户 - 完善的调试指引:文档详细覆盖常见错误(Invalid API Key、Invalid App Name)的排查步骤
潜在缺点与局限性
- 第三方代理依赖:所有请求必须经过 Maton 基础设施,存在单点故障风险和服务连续性依赖
- 速率限制:10 req/sec 的账户级限流,大规模企业集成可能受限
- 权限边界模糊:文档声明访问范围限定于"会议空间、记录和参与者",但未明确列出具体 OAuth Scope
- 写入操作需人工确认:虽然出于安全考虑,但自动化流程中要求"显式用户批准"可能阻碍完全自动化的场景
- Workspace 功能限制:录制和转录功能需要付费的 Google Workspace 订阅,且由 Google 端控制可用性
适合人群
- 快速原型开发者:需要在数小时内集成 Google Meet 功能,无暇自建 OAuth 服务
- 中小团队自动化:希望将会议创建、记录归档等工作流自动化的技术团队
- 多租户 SaaS 产品:需要在单个后端服务中代表多个终端用户管理 Google Meet 的 B2B 应用
常规风险
- 数据隐私:会议元数据、参与者信息、转录内容均流经 Maton 服务器,需评估其隐私政策与合规认证
- 供应商锁定:深度依赖 Maton 的代理层后,迁移至自建 Google OAuth 方案需重构认证逻辑
- 凭证泄露风险:
MATON_API_KEY作为统一凭证,一旦泄露将导致所有关联 Google 账户的 API 访问权限暴露 - Google API 变更同步延迟:Google Meet API 更新时,Maton 代理层的适配可能存在时间差