核心用法
gws-drive 是 Google Workspace Drive API v3 的命令行封装，提供对文件、文件夹、共享驱动器（Shared Drives）、权限、评论、版本修订等全生命周期管理能力。命令结构遵循 gws drive <resource> <method> [flags] 模式，支持 15 类资源（files、drives、permissions、revisions 等）共计 50+ 个 API 方法。
关键功能模块：
- 文件操作：上传（5TB 单文件限制）、下载、导出（Google Workspace 文档转格式）、复制、标签管理
- 共享驱动器：创建/隐藏/取消隐藏、元数据更新，支持企业级团队空间管理
- 权限与共享：精细化的 ACL 控制，支持角色分配与并发警告（同一文件并发操作仅最后生效）
- 变更追踪：changes.watch 实现推送通知，channels.stop 管理订阅生命周期
- 版本控制：revisions 列表/获取/删除（仅限二进制文件，文档类不可删末版本）
显著优点：
1. 原生 API 完整映射：直接暴露 Google 官方 Drive v3 全部能力，无功能阉割
2. 企业级规模支持：单文件 5TB 上传、共享驱动器、访问审批提案（accessproposals）等企业特性
3. 字段级控制：所有方法支持 fields 参数精确指定返回字段，减少数据传输
4. 与 gws 生态整合：依赖 gws 二进制统一认证，复用共享的 OAuth 令牌管理
潜在缺点与局限性：
- 认证门槛：需预先配置 Google Cloud OAuth 2.0 应用，获取 refresh token 流程复杂
- 无图形化辅助：纯 CLI 交互，对非技术用户学习曲线陡峭
- 并发限制明确：权限操作并发冲突警告（"only the last update is applied"），需客户端自行串行化
- 版本历史不完整风险：revisions.list 对高频编辑文档可能省略旧版本，首条非最早版本
适合人群：
- DevOps/SRE 工程师构建云存储自动化流水线
- 企业 IT 管理员批量管理共享驱动器与权限策略
- 开发者集成 Drive 变更通知到自建系统
常规风险：
- OAuth 令牌泄露导致数据暴露；refresh token 需安全存储
files.list默认返回含已删除文件，需显式trashed=false过滤- 权限操作并发竞态条件可能导致意外 ACL 状态
- 大文件上传/导出受网络稳定性影响，建议实现断点续传