gws-docs 是 Google Workspace CLI 提供的命令行技能,用于读取和写入 Google Docs。其调用形式为 gws docs <resource> <method> [flags],底层对应 Google Docs API v1。
用途:在命令行环境中对 Google 文档进行读写操作,便于脚本化和自动化处理文档内容。
主要能力:
- 辅助命令 +write:向文档追加文本。
- documents 资源下的方法:
- batchUpdate:对文档应用一个或多个更新。每个请求在应用前会被校验;若任一请求无效,则整个请求失败且不会应用任何更改。部分请求会返回回复以说明应用方式,其他请求返回空回复,回复顺序与请求顺序一致。
- create:使用请求中给定的标题创建空白文档。请求中的其他字段(包括提供的内容)会被忽略,返回创建的文档。
- get:获取指定文档的最新版本。
使用方式:
- 前置条件:需先阅读 ../gws-shared/SKILL.md 以了解认证、全局标志和安全规则;若该文件缺失,运行 gws generate-skills 生成。
- 发现命令:在调用任何 API 方法前,可先查看帮助与结构:
- 浏览资源与方法:
gws docs --help - 查看某方法所需参数、类型与默认值:
gws schema docs.<resource>.<method>
- 浏览资源与方法:
- 使用 gws schema 的输出构建 --params 和 --json 标志。
适用场景:需要在命令行或自动化流程中创建、读取、批量更新 Google 文档,或向文档追加文本的任务。
限制:资料未提供关于收费、价格、平台支持范围、性能效果等更多信息,暂未提供。