核心用法
gws-docs-write 是 Google Workspace CLI (gws) 的子命令，专门用于向指定 Google Docs 文档追加纯文本内容。其定位清晰：极简写入，无格式化负担。
基本语法：
gws docs +write --document <DOC_ID> --text "要追加的文本"
文本自动插入文档末尾，适合场景包括：
- 自动化报告生成（将分析结果追加到共享文档）
- 日志聚合（多源数据统一写入指定文档）
- 协作模板填充（在固定模板后追加动态内容）
与完整 API 的关系： 该命令是 batchUpdate API 的精简封装，牺牲富文本能力换取调用简洁性。如需标题样式、表格、图片等，需直接使用底层 API。
显著优点
- 极低心智负担：仅需文档 ID 和纯文本，无需处理 JSON 请求体或 OAuth 范围细粒度配置
- 幂等友好：追加操作天然幂等（多次执行不会覆盖），适合脚本重试逻辑
- CLI 原生集成：继承
gws全局认证与配置，无需单独管理凭据
潜在局限
- 纯文本限制：无法设置字体、颜色、超链接、标题层级等任何格式
- 仅追加模式：不支持定点插入、替换或删除，灵活性受限
- 依赖 gws 生态：必须先完成
gws全局认证（OAuth2/Service Account），单命令无法独立运行 - 无并发控制：高频追加可能触发 API 配额或产生冲突版本（Google Docs 自动保存机制下风险较低但非零）
适合人群
- 运维/数据工程师：需将脚本输出发送到共享文档作为轻量级持久化
- 自动化流程设计者：构建无代码/低代码流水线时的"写入 Google Docs"节点
- 团队协作者：快速生成会议记录、待办清单的追加型模板
常规风险
| 风险类型 | 说明 |
|---------|------|
| **意外追加** | 文档 ID 错误导致内容写入非目标文档；建议执行前二次确认 |
| **权限泄露** | `gws` 凭据通常拥有广泛 Docs 访问权限，共享环境需警惕 |
| **内容注入** | 若 `--text` 参数来自外部输入，需防范换行符注入或敏感信息泄露 |
| **无回滚** | 追加操作不可逆（除非手动撤销），重要文档建议先备份 |
> 官方明确标记 CAUTION：执行前须与用户确认，避免误操作。