核心用法
recipe-backup-sheet-as-csv 是一个自动化脚本技能,用于将 Google Sheets 电子表格导出为 CSV 格式,主要满足本地备份和数据二次处理需求。该技能依赖 gws 命令行工具,并需要预先加载 gws-sheets 和 gws-drive 两个核心技能。
执行流程包含三步:首先通过 gws sheets spreadsheets get 获取表格元数据,确认目标表格存在且可访问;随后使用 gws drive files export 执行官方 API 导出,支持标准 MIME 类型 text/csv;或者采用替代方案 gws sheets +read 直接读取指定工作表范围的值并输出 CSV 格式。
显著优点
1. 官方 API 保障:基于 Google Workspace API 原生导出能力,数据完整性和格式兼容性有保证
2. 双路径冗余:提供 Drive Export 和 Sheets Direct Read 两种导出方式,适应不同权限场景
3. 零本地配置:依赖云端 gws 工具链,无需本地安装复杂依赖
4. 版本可追溯:明确标注 v0.22.5,处于持续维护状态
潜在局限
- 权限门槛:需具备目标表格的读取权限,且
gws需完成 OAuth 授权 - 单表限制:默认针对单个 Spreadsheet,批量处理需外层循环封装
- 格式损失:导出 CSV 会丢失公式、格式、注释等非原始数据内容
- 大表风险:超大规模表格(百万行级)可能触发 API 超时或内存限制
适合人群
数据分析师、运维工程师、需要定期备份云端表格的企业用户,以及构建自动化数据管道的开发者。
常规风险
- 数据泄露:CSV 文件以明文存储,导出后需妥善保管
- 权限扩散:
gws的 OAuth token 若泄露可能导致 Drive/Sheets 数据被未授权访问 - 误操作覆盖:自动化脚本中若文件名固定,可能造成历史备份被覆盖