核心用法
本技能提供生产级 Google Sheets CLI 工具，通过服务账号（Service Account）认证实现程序化表格操作。核心工作流包括：
1. 认证设置：创建 Google Cloud 项目，启用 Sheets API，生成服务账号并下载 JSON 密钥，将目标表格共享给服务账号邮箱
2. 凭证管理：支持 6 种凭证来源，优先级为环境变量（GOOGLE_SHEETS_CREDENTIALS_JSON 内联字符串 → GOOGLE_SERVICE_ACCOUNT_KEY 文件路径）→ 标准环境变量 GOOGLE_APPLICATION_CREDENTIALS → 本地配置文件（./service-account.json 等）→ 用户配置目录 ~/.config/google-sheets/credentials.json
3. 数据操作：提供完整的 CRUD 能力，包括 read/write/append/clear 单区域操作，batchGet/batchWrite 批量处理，支持 JSON-in/JSON-out 管道化输出
4. 格式化与布局：涵盖单元格格式（format/getFormat）、边框（borders）、合并/取消合并（merge/unmerge）、列宽调整（resize/autoResize）、冻结窗格（freeze）及格式复制（copyFormat）
5. 工作表管理：支持创建新表格（create）、获取元信息（info）、增删重命名工作表（addSheet/deleteSheet/renameSheet）
6. 高级功能：batch 命令暴露原始 spreadsheets.batchUpdate 接口，满足自定义需求
显著优点
- 管道友好：JSON 输入输出设计，无缝集成 CI/CD 与数据处理流水线
- 凭证灵活：多重凭证来源自动回退，适配本地开发到生产部署的不同场景
- 功能完备：覆盖数据、格式、布局、工作表四级操作，超越基础读写需求
- 批量优化：原生支持批量 API，降低大数据处理时的请求频次与延迟
潜在缺点与局限性
- 认证模式单一：仅支持服务账号，不支持 OAuth 2.0 授权码流，无法满足需要终端用户授权的场景（如访问用户私人 Google 账号中的表格）
- 配置门槛：需要预先完成 Google Cloud 项目创建、API 启用、服务账号配置及表格共享，对非 GCP 用户存在学习曲线
- 权限模型限制：服务账号需显式共享表格，无法自动访问 Google Workspace 域内所有表格
- 无内置重试：虽文档建议对 429/5xx 错误实现指数退避，但需用户自行实现
适合人群
- 构建 ETL 管道、报表自动化系统的后端开发者与数据工程师
- 需要程序化批量处理表格格式与布局的运维团队
- 已在 Google Cloud 生态内运行的企业工作负载
- 寻求 JSON 接口替代手动 Sheets UI 操作的 DevOps 工程师
常规风险
- 凭证泄露风险：服务账号密钥文件若提交至版本控制或日志输出，可导致未授权数据访问；技能文档已明确警示禁止此类行为
- 数据覆盖风险：
write操作直接覆盖目标区域，无内置确认机制，误操作可能导致数据丢失 - API 配额限制：Google Sheets API 存在每项目/每用户请求配额，高频批量操作可能触发限流
- 权限扩散风险：服务账号共享范围若过于宽泛，可能违反最小权限原则