（5191期）google-sheets – 托管式 Google 表格 API 集成

托管式 Google 表格 API 集成 Maton 提供的 Google Sheets API 托管集成方案，通过 OAuth 代理实现表格读写、格式化与批量操作，无需自建认证基础设施。 使用说明 核心用法 google-sheets skill 是一个纯文档型 API 集成工具，通过 Maton 托管网关代理访问 Google Sheets API。用户需先在 maton.ai 注册获取 MATONAPIKEY，并在 ctrl.maton.ai 管理 Google OAuth 连接。完成授权后，即可通过标准 REST API 调用实现：电子表格元数据读取、单元格数值读写（支持批量操作）、工作表创建与删除、单元格格式化（颜色、字体、对齐）、行列插入与自动调整、数据排序与筛选等完整功能。API 路径与官方 Google Sheets API 保持一致，仅将 sheets.googleapis.com 替换为 gateway.maton.ai/google-sheets，由网关自动注入 OAuth 令牌。 显著优点 托管式 OAuth 简化集成：无需开发者自行处理 Google Cloud 项目配置、OAuth 2.0 授权流程和令牌刷新，大幅降低接入门槛。完整 API 覆盖：支持官方 API 的几乎所有核心功能，包括复杂的 batchUpdate 格式化操作。多账户管理：通过 Maton-Connection 头部可灵活切换多个 Google 账户，适合团队协作场景。多语言示例完备：提供 Python、JavaScript、Bash 等语言的完整代码示例，降低学习成本。无本地依赖：纯文档 skill，不引入任何第三方库，避免依赖冲突和供应链风险。 潜在缺点与局限性 服务商锁定：完全依赖 Maton 网关服务的可用性，若服务中断则无法使用。数据隐私顾虑：所有表格数据需流经 Maton 服务器，对敏感数据场景存在合规风险。速率限制：默认 10 req/sec 的限速可能无法满足高频数据同步需求。功能边界：删除电子表格需调用 Google Drive API，不在本 skill 支持范围内。调试复杂度：curl 使用时需注意 URL 编码和 glob 解析问题，错误信息为 Google API 透传，排查需一定经验。 适合的目标群体 快速原型开发者：需要快速验证 Google Sheets 集成方案，不愿投入时间搭建 OAuth 基础设施。自动化脚本编写者：希望用 Python/JS 实现表格数据同步、报表生成的工程师。小型团队：缺乏 DevOps 资源，需要即开即用的托管 API 服务。教育与非商业场景：MIT 许可证友好，适合教学演示和个人项目。 使用风险 服务可用性风险：Maton 作为第三方服务，存在单点故障可能，关键业务需考虑降级方案。API Key 泄露风险：MATONAPIKEY 需妥善保管，硬编码或日志泄露可能导致未授权访问。数据合规风险：涉及 PII 或商业机密数据时，需评估 Maton 的数据处理协议是否符合 GDPR/SOC2 等要求。版本兼容性风险：Google Sheets API 更新后，Maton 网关的同步延迟可能影响新功能使用。 原始说明 Google Sheets API integration with managed OAuth. Read and write spreadsheet data, create sheets, apply formatting, and manage ranges. Use this skill when users want to read from or write to Google Sheets. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).