云端 Excel 自动化，零 OAuth 负担

通过 Maton 代理连接 Microsoft Graph Excel API，实现 OneDrive/SharePoint 工作簿的读写、表格管理与图表操作，支持托管 OAuth 认证。

基本信息

• 技能名称?Microsoft Excel
• 中文名称?云端 Excel 自动化，零 OAuth 负担
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.4
• 标签?microsoft-graph, excel, spreadsheet, onedrive, oauth, data-processing, api-gateway, enterprise

使用方法

使用说明
核心用法
Microsoft Excel Skill 是 Maton 平台提供的 Microsoft Graph API 代理服务，允许开发者通过统一的 RESTful 接口操作存储在 OneDrive 或 SharePoint 中的 Excel 文件。该 Skill 封装了 OAuth 认证流程，用户只需配置 MATON_API_KEY 环境变量即可发起调用，无需直接处理 Microsoft 的令牌管理。
主要功能覆盖：
工作簿操作 ：文件上传、搜索、元数据获取
工作表管理 ：增删改查工作表、调整顺序与可见性
单元格与区域 ：A1 格式的范围读写、公式计算、格式设置、批量更新
表格处理 ：结构化表格的创建、行列增删、样式应用
图表生成 ：基于数据范围添加可视化图表
会话管理 ：高性能批量操作的持久化会话（推荐用于大量写操作）
显著优点

1. 托管 OAuth 降低接入门槛 ：Maton 负责令牌刷新与权限管理，开发者专注业务逻辑
2. 原生 Graph API 能力 ：完整支持 Microsoft Graph Excel 端点的高级功能（如 usedRange 检测、表格结构化操作）
3. 灵活的连接管理 ：支持多账户切换（通过 Maton-Connection 头部），适合企业多租户场景
4. 多语言示例完备 ：提供 Bash/curl、Python、JavaScript 的即用代码片段
   潜在局限
   仅支持 .xlsx 格式 ：遗留的 .xls 二进制格式不兼容
   URL 编码敏感 ：工作表名含特殊字符、ID 中的 { } 需手动编码，易引发 404 错误
   会话有效期限制 ：持久会话约 5 分钟、非持久约 7 分钟闲置即过期，长任务需心跳维护
   网络依赖 ：所有操作需实时连接 Maton 代理与 Microsoft 云服务，离线场景不可用
   适合人群
   需自动化 Excel 数据处理的数据分析师、财务团队
   构建报表系统、数据同步管道的后端开发者
   希望将 Excel 作为轻量级数据库使用的 SaaS 集成场景
   常规风险
   写操作需二次确认 ：API 支持删除工作表/清除区域等破坏性操作，生产环境务必添加人工审核或逻辑校验
   API Key 泄露风险 ： MATON_API_KEY 拥有账户级访问权限，应避免硬编码、使用密钥管理服务
   Microsoft 侧限流 ：依赖 Graph API 的 429 限流策略，高频批量操作需实现指数退避重试