SuperAPI AI 工具集

gws-drive

通用与其它

查看项目

更新于 10-15 21:10

技能介绍

gws-drive 用于通过命令行调用 Google Drive v3 API,管理文件、文件夹和共享云端硬盘。基本形式为 gws drive <resource> <method> [flags],另提供 +upload 辅助命令实现带自动元数据的上传。

使用前需先阅读 ../gws-shared/SKILL.md 获取认证、全局参数与安全规则;若该文件缺失,运行 gws generate-skills 生成。

主要 API 资源与能力:about 获取用户与系统信息;files 提供复制、创建、删除、下载(24 小时有效)、导出(上限 10 MB)、生成 ID、获取、列表、标签列表与修改、更新与监听,创建和更新支持 /upload,最大文件 5,120 GB;permissions 管理文件或共享云端硬盘的权限,同一文件的并发权限操作不受支持,仅最后一次生效;drives 管理共享云端硬盘(创建、删除、获取、隐藏、列出、取消隐藏、更新);changes 与 channels 用于变更跟踪与通知订阅;comments 与 replies 管理评论和回复;revisions 管理文件修订版本,仅可删除二进制内容文件的修订;accessproposals 管理访问提案,仅审批者可列出;approvals、apps、operations 提供审批、应用与长时操作查询。teamdrives 下的方法已弃用,应改用 drives 对应方法。

使用方式:先用 gws drive --help 浏览资源与方法,再用 gws schema drive.<resource>.<method> 查看必填参数、类型与默认值,据此构建 --params 和 --json 参数。

限制与注意事项:comments 等部分方法必须设置 fields 参数;files.list 默认返回包括已回收站文件,可用 trashed=false 排除;files.get 使用 alt=media 仅在文件存储于 Drive 时可用;大规模修订历史下 revisions.list 可能不完整。文档未提供定价或平台支持信息。