用途
gws-docs-write 是 Google Workspace CLI(gws)中面向 Google Docs 的写入类命令,用于向指定 Google 文档追加纯文本内容。它适合在自动化流程或命令行环境中快速向文档末尾添加文本。
主要能力
- 将纯文本追加到文档正文末尾。
- 通过命令行参数指定目标文档和文本内容。
- 作为 gws docs 系列命令的一部分,与读取命令配合使用。
使用方式
命令格式:
gws docs +write --document <ID> --text <TEXT>
参数说明:
- --document(必填):文档 ID。
- --text(必填):要追加的文本,纯文本格式。
示例:
gws docs +write --document DOC_ID --text 'Hello, world!'
前置条件:需先阅读 ../gws-shared/SKILL.md 了解认证、全局参数和安全规则;若该文件缺失,可运行 gws generate-skills 生成。
适用场景
- 在脚本或自动化任务中向 Google 文档追加文本。
- 需要以命令行方式快速写入文档内容的场景。
限制与注意事项
- 文本插入位置为文档正文末尾。
- 仅支持纯文本;如需富文本格式,应改用原始 batchUpdate API。
- 这是写命令,执行前需与用户确认。
- 更多全局参数和认证信息参见 gws-shared;所有读写 Google Docs 命令参见 gws-docs。