核心用法
本技能通过 Maton 网关代理 Google Meet REST API,开发者仅需配置 MATON_API_KEY 即可调用完整的 Meet 功能,无需自行处理 OAuth 2.0 流程。基础用法涵盖:
- 会议空间管理:创建持久化的
spaces(可复用的会议室),配置访问权限(OPEN/TRUSTED/RESTRICTED),获取会议链接与代码 - 会议记录追踪:通过
conferenceRecords查询历史会议元数据,支持按空间过滤 - 参会者分析:列出会议参与者及其会话时长,获取详细的
participantSessions - 录制与转录:在 Workspace 订阅支持下,下载会议录制文件及逐字稿条目
所有请求均通过 https://gateway.maton.ai/google-meet/{native-api-path} 转发,Maton 自动注入 OAuth Token。多连接场景下可通过 Maton-Connection 头部指定特定 Google 账号。
显著优点
1. 零 OAuth 运维:Maton 托管 Google 授权生命周期,开发者免于维护 refresh token 与 token 轮换
2. 原生 API 透传:支持 Google Meet API 的全部能力,包括 spaces、recordings、transcripts 等 Beta 功能
3. 多租户隔离:支持多 Google 账号连接,通过 header 灵活切换,适合 SaaS 多租户场景
4. 多语言示例完备:提供 Python、JavaScript、Bash 的完整代码片段,降低接入门槛
潜在缺点与局限性
- 依赖 Maton 服务可用性:网关故障将完全阻断 API 访问,存在单点依赖风险
- 速率限制:账户级 10 req/sec 限制,大规模并发场景需自行实现退避重试
- 录制功能受限:必须订阅 Google Workspace 且管理员开启录制权限,免费 Gmail 账号无法使用
- 连接状态隐性依赖:若 OAuth 连接失效(用户撤销授权),错误 400 提示较为模糊,需人工到控制面板排查
适合人群
- 需要自动化会议创建(如预约系统对接)的 SaaS 开发者
- 希望分析会议参与度、获取转录数据的企业数据团队
- 构建会议录制归档、合规审计系统的管理员
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 转录文件可能包含敏感对话内容,需确保录制下载后的存储加密 |
| 越权访问 | 错误配置 `accessType: OPEN` 可能导致外部人员闯入会议空间 |
| 授权回收 | 用户随时可在 Google 账号中撤销 Maton 授权,导致自动化流程中断 |
| 第三方信任 | Maton 作为 OAuth 代理,理论上具备访问用户 Meet 数据的权限,需评估其隐私政策合规性 |
建议在非生产环境先行验证连接生命周期管理,并实施会议链接的过期与访问审计策略。