该技能用于通过 Maton 网关访问 Google Sheets API,采用托管 OAuth 认证,无需自行处理 Google OAuth 令牌。所有请求的 Base URL 为 https://gateway.maton.ai/google-sheets/{native-api-path},网关会转发到 sheets.googleapis.com 并自动注入 OAuth 令牌。
用途与主要能力:读写电子表格值、批量读写多区域、创建电子表格、追加与清除值,以及通过 batchUpdate 执行格式化、新增工作表、重命名、插入行列、排序、添加筛选器、删除工作表等操作,也可获取表格元数据。
使用方式:所有请求需在 Authorization 头中携带 Maton API 密钥,环境变量为 MATON_API_KEY。API 密钥可在 maton.ai 注册后于 maton.ai/settings 获取。OAuth 连接在 https://ctrl.maton.ai 管理,可列出、创建、获取和删除连接;多个 Google 账号时用 Maton-Connection 头指定连接,省略则使用默认(最早)的活动连接。写值时可使用 valueInputOption,RAW 原样存储,USER_ENTERED 会解析公式与数字。使用 curl 时 URL 路径中的区域需编码(! 为 %21,: 为 %3A),JavaScript fetch 与 Python requests 会自动编码;curl 命令中 URL 含方括号时需使用 curl -g。
适用场景:需要在脚本或自动化流程中读取、写入、格式化 Google 表格数据,且希望简化 OAuth 认证的开发者。
限制:需先拥有 Maton 账号与 API 密钥并建立 Google OAuth 连接;速率限制为每账号每秒 10 次请求;删除电子表格需使用 Google Drive API,而非 Sheets API;工作表 ID 为数字,可从表格元数据获取。返回的状态码包括 400(缺少 Google Sheets 连接)、401(无效或缺失 Maton API 密钥)、429(限流)以及来自 Google Sheets API 的 4xx/5xx 透传错误。收费与价格信息暂未提供。