google-slides

核心用法

本 Skill 提供通过 Maton 网关访问 Google Slides API 的完整指南，采用托管 OAuth 模式简化认证流程。用户需先在 maton.ai 获取 MATON_API_KEY，并在 ctrl.maton.ai 完成 Google 账号授权，即可通过标准 HTTP 请求调用完整的 Slides API 能力。

主要功能包括：创建演示文稿（Create Presentation）、批量更新（Batch Update）、幻灯片管理（Create/Delete Slides）、内容插入（Text/Image/Shapes）、样式控制（Update Text Style）以及模板替换（Replace All Text）。所有修改操作均通过 batchUpdate 端点以原子方式提交，支持 9 种预定义布局（BLANK、TITLE_AND_BODY 等）。

显著优点

1. 零 OAuth 开发成本：Maton 托管 OAuth 流程，开发者无需处理 Google Cloud Console 配置、授权回调等复杂环节
2. 原生 API 完整覆盖：直接透传 Google Slides REST API，功能与官方 API 100% 对齐
3. 多语言示例完备：提供 Python、JavaScript、Bash 等可直接运行的代码片段
4. 连接管理灵活：支持多账号连接切换，通过 Maton-Connection 头部指定特定连接
5. 原子操作保障：batchUpdate 内多个请求要么全部成功，要么全部失败，避免数据不一致

潜在缺点与局限性

1. 第三方网关依赖：所有流量必须经过 gateway.maton.ai，存在单点故障和服务可用性风险
2. 网络强依赖：完全离线环境无法使用，且受 Maton 平台稳定性制约
3. 速率限制：默认 10 req/sec 的账户级限流，大规模批量操作可能受限
4. T3 来源可信度：作者为社区/个人（Maton），非 Google 官方或企业级供应商
5. 数据隐私顾虑：演示文稿内容需经过第三方网关转发，敏感商业信息需谨慎评估

适合的目标群体

• 自动化报告生成：需将数据分析结果（如 BI 报表、实验数据）自动转为演示文稿的数据团队
• 内容运营团队：批量生成营销材料、培训课件等模板化内容
• 开发者集成：需要将 Slides 功能嵌入内部工具或工作流的技术团队
• AI 内容工作流：结合 LLM 生成内容后自动导出到 Google Slides 的场景

使用风险

• API Key 泄露风险：MATON_API_KEY 是访问凭证，硬编码或日志泄露可能导致未授权访问
• OAuth 令牌生命周期：需关注连接状态（ACTIVE/EXPIRED），过期后需重新授权
• 网关服务变更：Maton 平台 API 路径或认证方式变更可能导致现有代码失效
• Google API 配额：除 Maton 限流外，仍受 Google Slides API 自身配额限制
• 数据驻留合规：数据流经美国服务器（gateway.maton.ai），需符合企业数据出境合规要求

核心用法

Google Slides Skill 是一套完整的 Google Slides API 集成文档，通过 Maton 托管的 OAuth 网关实现免配置认证。核心能力包括：

1. 演示文稿管理：创建新演示文稿、获取现有文稿元数据、管理幻灯片页面
2. 内容批量操作：通过 batchUpdate 端点原子性执行多步骤修改，包括创建幻灯片、插入文本/图片/形状、更新样式、删除对象等
3. 模板化生成：利用 replaceAllText 实现占位符替换，快速生成标准化演示文稿
4. 连接管理：支持多账号场景，通过 Maton-Connection 头部指定特定 Google 账号

技术路径：用户请求 → Maton Gateway (gateway.maton.ai) → Google Slides API，Maton 自动注入 OAuth Token，开发者仅需管理 MATON_API_KEY。

显著优点

• 零 OAuth 配置成本：无需处理 Google OAuth 2.0 的复杂流程，Maton 集中托管令牌生命周期
• 原生 API 透明代理：完全兼容 Google Slides REST API 语义，可直接复用官方文档
• 多语言示例完备：提供 Python (urllib/request)、JavaScript (fetch)、curl 的即用代码片段
• 批量操作原子性：batchUpdate 的多请求要么全部成功，要么全部回滚，避免状态不一致
• 布局模板丰富：9 种预定义布局（BLANK、TITLE_AND_BODY、TITLE_AND_TWO_COLUMNS 等）开箱即用

潜在局限

• 第三方网关依赖：所有流量经 Maton 中转，存在单点故障和供应商锁定风险
• 速率限制：默认 10 req/sec 每账号，大规模自动化场景可能受限
• 纯文档型 Skill：无内置 LLM 意图解析，需用户自行构造 API 请求体
• 网络硬依赖：无法离线使用，企业内网需显式放行 maton.ai 域名
• 数据隐私顾虑：演示文稿内容流经第三方基础设施，敏感数据场景需额外评估

适合人群

• 自动化报告生成：需将数据库/分析结果定期转为幻灯片的业务分析师
• 模板驱动工作流：市场、销售团队批量生成定制化提案、报价单
• 低代码集成者：希望绕过 OAuth 配置，快速原型验证的开发者
• 多账号管理者：需在同一应用内切换个人/企业 Google 账号的高级用户

常规风险

| 风险类别 | 详情 | 缓解建议 |

|---------|------|---------|

| 凭证泄露 | `MATON_API_KEY` 泄露可导致账户被滥用 | 使用 Secrets Manager，定期轮换（90天周期） |

| 数据外泄 | 内容经 Maton 网关传输至 Google | 审查 Maton 隐私政策，避免嵌入 PII/机密数据 |

| 授权范围失控 | OAuth 连接长期有效，权限可能过时 | 定期审计 `ctrl.maton.ai/connections`，删除闲置连接 |

| 供应链攻击 | Maton 网关或 Skill 仓库被篡改 | 锁定版本，关注 openclaw 仓库更新动态 |

| 速率超限 | 突发流量触发 429 错误 | 实现指数退避重试，或联系 Maton 提升限额 |

---

> 认证摘要：CLS-Certify A 级（78分），T2 来源可信度。纯 Markdown 文档型 Skill，无可执行代码，外部 API 调用均指向可信域名，API Key 通过环境变量安全传入。