用途:gws-drive 是 Google Workspace CLI 的 Drive v3 技能,用于在命令行中管理 Google Drive 的文件、文件夹与共享云端硬盘。
主要能力:覆盖 Drive API 的多个资源,包括 about、accessproposals、approvals、apps、changes、channels、comments、drives、files、operations、permissions、replies、revisions、teamdrives。文件操作支持上传、下载、导出、复制、创建、更新、生成 ID、列出标签与修改标签;共享云端硬盘支持创建、获取、隐藏、列出、取消隐藏与更新;权限支持创建、删除、获取、列出与更新;评论与回复支持增删改查;变更支持获取起始 pageToken、列出与订阅通知。另提供 +upload 辅助命令,可自动附带元数据上传文件。
使用方式:先阅读 ../gws-shared/SKILL.md 获取认证、全局参数与安全规则;若缺失,运行 gws generate-skills 生成。命令格式为 gws drive <resource> <method> [flags]。调用前可用 gws drive --help 浏览资源与方法,用 gws schema drive.<resource>.<method> 查看必填参数、类型与默认值,再据此构造 --params 与 --json。
适用场景:需要在脚本或终端中批量管理 Drive 文件、共享盘、权限、评论与变更通知时使用。
限制:部分方法要求设置 fields 参数;files.create 与 files.update 支持 /upload URI,最大文件 5,120 GB,接受任意有效 MIME 类型;files.export 导出内容上限 10 MB;files.download 操作自创建起 24 小时内有效;同一文件的并发权限操作不受支持,仅最后一次更新生效;revisions.delete 仅适用于二进制内容文件,Google Docs/Sheets 等及最后一个版本不可删除;revisions.list 对修订历史较多的文件可能不完整;accessproposals.list 仅审批者可调用,否则返回 403;teamdrives 相关方法已弃用,应改用 drives 对应方法。认证、全局参数与安全规则的具体内容暂未提供。