gws-drive 是 Google Workspace CLI 提供的 Google Drive（v3）命令行技能，用于在命令行中管理 Google Drive 的文件、文件夹和共享云端硬盘。
【用途】
把 Google Drive API v3 的资源与方法映射为命令行操作，方便在脚本或终端中完成文件与共享盘管理。命令形式为 gws drive <resource> <method> [flags]。
【前置条件】
需先阅读 ../gws-shared/SKILL.md，了解认证、全局标志和安全规则。若该文件缺失，运行 gws generate-skills 生成。
【主要能力】 按 API 资源划分：
- about：get，获取用户、用户 Drive 与系统能力信息（必须设置 fields 参数）。
- accessproposals：get、list、resolve，查看与处理待审批的访问提案（仅审批者可列出文件上的访问提案）。
- approvals：get、list，获取或列出文件上的审批。
- apps：get、list，获取指定应用或列出用户已安装的应用。
- changes：getStartPageToken、list、watch，用于获取变更起始 pageToken、列出变更、订阅变更。
- channels：stop，停止通过该频道对资源的监听。
- comments：create、delete、get、list、update，管理文件评论（create/get/list/update 需设置 fields 参数）。
- drives：create、get、hide、list、unhide、update，管理共享云端硬盘（list 支持 q 查询参数）。
- files：copy、create、download、export、generateIds、get、list、listLabels、modifyLabels、update、watch。create/update 支持 /upload URI，最大文件 5,120 GB，接受任意有效 MIME 类型；export 导出内容上限 10 MB；download 操作自创建起 24 小时内有效；get 使用 alt=media 可返回内容（仅限存储在 Drive 中的文件）；list 默认返回全部文件（含已回收站文件），可用 trashed=false 过滤。
- operations：get，获取长时间运行操作的最新状态。
- permissions：create、delete、get、list、update，管理文件或共享盘的权限；注意同一文件上并发的权限操作不受支持，只有最后一次更新生效。
- replies：create、delete、get、list、update，管理评论的回复。
- revisions：delete、get、list、update，管理文件修订版本；只能删除二进制内容文件（如图片、视频）的修订，Google Docs/Sheets 等文件及最后一个保留版本的修订不可删除；修订历史较多的文件返回列表可能不完整。
- teamdrives：create、get、list、update，均已弃用，改用 drives.* 对应方法。
辅助命令：+upload，上传文件并自动写入元数据。
【使用方式】 调用任何 API 方法前先查看：
# 浏览资源和方法
gws drive --help
# 查看某方法的必填参数、类型和默认值
gws schema drive.<resource>.<method>
然后根据 gws schema 的输出构造 --params 和 --json 标志。
【适用场景】 需要在命令行或自动化脚本中批量上传/下载/导出文件、搜索文件与共享盘、管理共享云端硬盘、设置与查询权限、管理评论与回复、跟踪文件变更、处理修订版本等。
【限制与注意事项】 部分方法必须设置 fields 参数；export 导出上限 10 MB；download 操作 24 小时内有效；alt=media 下载仅对存储在 Drive 中的文件有效；并发权限操作只应用最后一次；revisions 的限制如上；teamdrives 系列方法已弃用。认证、全局标志与安全规则详见 gws-shared 文档。