通过 Maton API Gateway 与 Google Sheets 交互，使用 curl 读取、写入、追加和清除电子表格数据。在用户提及相关需求时使用此技能。
Google Sheet matan.
功能概述
Google Sheet matan.是一项面向实际任务的技能，主要用于Google Sheets (Generic,通过Maton Gateway). 通过 Maton Gateway 访问和管理任何 Google Sheets 电子表格,并获得 OAuth 认证；支持读取、写写、 上行。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Google Sheets matan
Google Sheets（通用版，通过 Maton Gateway）
通过 Maton Gateway，使用完整的 OAuth 认证机制访问和管理任意 Google Sheets 电子表格。支持读取、写入、更新、追加、清空、格式设置、工作表管理、公式及区域保护等功能。
🌐 基础 URL
https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/{native-api-path}
{SPREADSHEET_ID} → 您的电子表格 ID
{native-api-path} → Google Sheets API 路径（例如 values、sheets 等）
🔐 认证
在请求头中包含您的 Maton API 密钥：
-H "Authorization: Bearer $MATON_API_KEY"
在环境中设置：
export MATON_API_KEY="YOUR_API_KEY"
📄 操作（通用占位符）
- 读取单元格值
curl "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}!{RANGE}"
-H "Authorization: Bearer $MATON_API_KEY"
占位符说明：
{SHEET_NAME} → 任意工作表（Tab）名称
{RANGE} → A1 表示法（例如 A1:Z100）
2. 追加单元格值
向工作表底部添加新行。
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}!{RANGE}:append?valueInputOption=USER_ENTERED"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"values": [
["{VALUE1}", "{VALUE2}", "{VALUE3}", "...", "{VALUEN}"]
]
}'
{VALUE1} … {VALUEN} → 任意通用值
3. 更新单元格值
curl -X PUT "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}!{RANGE}?valueInputOption=USER_ENTERED"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"values": [
["{VALUE1}", "{VALUE2}", "{VALUE3}", "...", "{VALUEN}"]
]
}'
- 批量更新单元格值
一次性更新多个区域：
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/values:batchUpdate"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"valueInputOption":"USER_ENTERED",
"data":[
{"range":"{SHEET_NAME}!{RANGE1}","values":[["{VALUE1A}", "{VALUE1B}", "..."]]},
{"range":"{SHEET_NAME}!{RANGE2}","values":[["{VALUE2A}", "{VALUE2B}", "..."]]}
]
}'
清空单元格值
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}!{RANGE}:clear"
-H "Authorization: Bearer $MATON_API_KEY"获取电子表格元数据
curl "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}"
-H "Authorization: Bearer $MATON_API_KEY"
返回内容包括：工作表列表、属性、标题、ID 等。
7. 新增工作表
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}:batchUpdate"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"requests":[
{"addSheet":{"properties":{"title":"{NEW_SHEET_NAME}"}}}
]
}'
删除工作表
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}:batchUpdate"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"requests":[
{"deleteSheet":{"sheetId":{SHEET_ID}}}
]
}'复制工作表
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/sheets/{SHEET_ID}:copyTo"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"destinationSpreadsheetId":"{DEST_SPREADSHEET_ID}"
}'格式设置与单元格样式
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}:batchUpdate"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"requests":[
{
"repeatCell":{
"range":{"sheetId":{SHEET_ID},"startRowIndex":{START_ROW},"endRowIndex":{END_ROW},"startColumnIndex":{START_COL},"endColumnIndex":{END_COL}},
"cell":{"userEnteredFormat":{"backgroundColor":{"red":{R},"green":{G},"blue":{B}}}},
"fields":"userEnteredFormat.backgroundColor"
} }
] }'插入公式
curl -X PUT "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}!{CELL}?valueInputOption=USER_ENTERED"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"values":[["{FORMULA}"]]
}'受保护区域
curl -X POST "https://gateway.maton.ai/google-sheets/v4/spreadsheets/{SPREADSHEET_ID}:batchUpdate"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"requests":[
{"addProtectedRange":{"protectedRange":{"range":{"sheetId":{SHEET_ID},"startRowIndex":{START_ROW},"endRowIndex":{END_ROW}},"description":"{DESCRIPTION}"}}}
] }'
📚 补充说明
{SPREADSHEET_ID} → 您的电子表格 ID
{SHEET_NAME} → 任意工作表（Tab）名称
{RANGE} → A1 表示法（例如 A1:Z100）
{VALUE1}、{VALUE2}、… → 任意单元格内容的通用占位符
USER_ENTERED 会自动解析数字、日期和公式
所有结构性变更（如新增/删除工作表、格式设置、区域保护等）均需使用 batchUpdate 接口
相关专题
Java应用运行缓慢，如何调整JVM参数？本专题介绍OpenJDK JVM性能调优的基本流程，涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析，帮助你先定位瓶颈，再通过对照测试验证效果，避免直接套用参数而影响应用稳定性。
2026.10.16
0
10
怎样用OpenJDK搭建开发环境？本专题介绍版本选择、下载安装、环境变量配置和编译运行验证，帮助你理清JDK的作用及基本配置流程，并通过简单程序检查环境是否可用，为后续项目开发做好准备。
2026.10.16
0
10
Java项目开发完成后，怎样部署到目标环境并正常运行？本专题介绍OpenJDK应用部署流程，涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看，帮助你理清部署前后的操作顺序，减少环境差异造成的运行问题。
2026.10.16
0
10
本专题围绕Revel框架视图层开发，介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则，帮助开发者完成安全规范的页面交互。
2026.10.16
0
15
本专题聚焦Revel框架MVC核心机制，讲解路由定义、控制器Action、参数绑定、请求响应和反向路由，并结合常见场景梳理接口请求处理流程。
2026.10.16
0
15
本专题从Revel框架环境搭建讲起，系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载，帮助开发者快速完成首个Go Web应用。
2026.10.16
0
15
Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章，帮助按实际任务练习常用命令并建立命令行操作习惯。
2026.10.15
0
20
MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法，覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境，并提示恢复权限与重新登录的检查步骤。
2026.10.15
0
18
Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章，帮助结合实际状态类型选择合适写法。
2026.10.15
0
20
热门下载
相关下载
精品课程
