drive (v3)

前提条件：请先阅读 ../gws-shared/SKILL.md，了解认证（auth）、全局标志（global flags）及安全规则（security rules）。如该文件缺失，请运行 gws generate-skills 命令生成。

gws drive   [flags]

辅助命令

API 资源

about

• get — 获取用户、用户 Drive 及系统能力相关信息。更多信息，请参阅《返回用户信息》。必需：必须设置 fields 参数。如需仅返回特定字段，请参阅《返回特定字段》。

accessproposals

• get — 根据 ID 检索访问提议。更多信息，请参阅《管理待处理的访问提议》。
• list — 列出某文件上的所有访问提议。更多信息，请参阅《管理待处理的访问提议》。注意：仅审批人（approvers）可列出文件上的访问提议；若当前用户非审批人，将返回 403 错误。
• resolve — 批准或拒绝某访问提议。更多信息，请参阅《管理待处理的访问提议》。

approvals

• get — 根据 ID 获取一个 Approval。
• list — 列出某文件上的所有 Approvals。

apps

• get — 获取指定应用。更多信息，请参阅《返回用户信息》。
• list — 列出用户已安装的应用。更多信息，请参阅《返回用户信息》。

changes

• getStartPageToken — 获取用于后续变更列表的起始 pageToken。更多信息，请参阅《检索变更》。
• list — 列出用户或共享磁盘（shared drive）的变更。更多信息，请参阅《检索变更》。
• watch — 订阅用户资源的变更通知。更多信息，请参阅《资源变更通知》。

channels

• stop — 停止通过此 channel 监听资源变更。更多信息，请参阅《资源变更通知》。

comments

• create — 在文件上创建一条评论。更多信息，请参阅《管理评论与回复》。必需：必须设置 fields 参数。如需仅返回特定字段，请参阅《返回特定字段》。
• delete — 删除一条评论。更多信息，请参阅《管理评论与回复》。
• get — 根据 ID 获取一条评论。更多信息，请参阅《管理评论与回复》。必需：必须设置 fields 参数。如需仅返回特定字段，请参阅《返回特定字段》。
• list — 列出某文件的所有评论。更多信息，请参阅《管理评论与回复》。必需：必须设置 fields 参数。如需仅返回特定字段，请参阅《返回特定字段》。
• update — 使用 patch 语义更新一条评论。更多信息，请参阅《管理评论与回复》。必需：必须设置 fields 参数。如需仅返回特定字段，请参阅《返回特定字段》。

drives

• create — 创建一个共享磁盘（shared drive）。更多信息，请参阅《管理共享磁盘》。
• get — 根据 ID 获取共享磁盘的元数据。更多信息，请参阅《管理共享磁盘》。
• hide — 将共享磁盘从默认视图中隐藏。更多信息，请参阅《管理共享磁盘》。
• list — 列出用户的共享磁盘。该方法支持 q 参数，即一个包含一个或多个搜索词的查询字符串。更多信息，请参阅《搜索共享磁盘指南》。
• unhide — 将共享磁盘恢复至默认视图。更多信息，请参阅《管理共享磁盘》。
• update — 更新共享磁盘的元数据。更多信息，请参阅《管理共享磁盘》。

files

• copy — 创建文件副本，并按 patch 语义应用所请求的更新。更多信息，请参阅《创建和管理文件》。
• create — 创建一个文件。更多信息，请参阅《创建和管理文件》。该方法支持 /upload URI，并接受如下特性的上传媒体：- 最大文件大小：5,120 GB；- 支持的媒体 MIME 类型：*/*（请指定有效的 MIME 类型，而非字面值 */*；此处字面值 */* 仅表示任何有效 MIME 类型均可上传）。
• download — 下载文件内容。更多信息，请参阅《下载与导出文件》。相关操作自创建起 24 小时内有效。
• export — 将 Google Workspace 文档导出为指定 MIME 类型，并返回导出的字节内容。更多信息，请参阅《下载与导出文件》。注意：导出内容大小上限为 10 MB。
• generateIds — 生成一组文件 ID，可用于 create 或 copy 请求。更多信息，请参阅《创建和管理文件》。
• get — 根据 ID 获取文件的元数据或内容。更多信息，请参阅《搜索文件与文件夹》。若在 URL 中指定参数 alt=media，响应体将直接包含文件内容。使用 alt=media 下载内容仅对存储于 Drive 中的文件有效。
• list — 列出用户的全部文件。更多信息，请参阅《搜索文件与文件夹》。该方法支持 q 参数，即一个包含一个或多个搜索词的查询字符串。该方法默认返回 所有 文件（包括已移入回收站的文件）。如不希望回收站中的文件出现在结果中，请使用查询参数 trashed=false 排除这些文件。
• listLabels — 列出文件上的标签。更多信息，请参阅《列出文件上的标签》。
• modifyLabels — 修改应用于文件的一组标签。更多信息，请参阅《为文件设置标签字段》。返回已添加或修改的标签列表。
• update — 更新文件的元数据、内容，或二者同时更新。调用该方法时，请仅填充请求中需要修改的字段；更新过程中部分字段（例如 modifiedDate）可能被自动修改。该方法支持 patch 语义。该方法支持 /upload URI，并接受如下特性的上传媒体：- 最大文件大小：5,120 GB；- 支持的媒体 MIME 类型：*/*（请指定有效的 MIME 类型，而非字面值 */*）。
• watch — 订阅某文件的变更通知。更多信息，请参阅《资源变更通知》。

operations

• get — 获取长期运行操作（long-running operation）的最新状态。客户端可根据 API 服务建议的时间间隔，轮询该操作的结果。

permissions

• create — 为文件或共享磁盘创建权限。更多信息，请参阅《共享文件、文件夹与磁盘》。警告：不支持对同一文件并发执行权限操作；仅最后一次更新生效。
• delete — 删除权限。更多信息，请参阅《共享文件、文件夹与磁盘》。警告：不支持对同一文件并发执行权限操作；仅最后一次更新生效。
• get — 根据 ID 获取权限。更多信息，请参阅《共享文件、文件夹与磁盘》。
• list — 列出文件或共享磁盘的权限。更多信息，请参阅《共享文件、文件夹与磁盘》。
• update — 使用 patch 语义更新权限。更多信息，请参阅《共享文件、文件夹与磁盘》。警告：不支持对同一文件并发执行权限操作；仅最后一次更新生效。

replies

• create — 创建对某条评论的回复。更多信息，请参阅《管理评论与回复》。
• delete — 删除一条回复。更多信息，请参阅《管理评论与回复》。
• get — 根据 ID 获取一条回复。更多信息，请参阅《管理评论与回复》。
• list — 列出某条评论的所有回复。更多信息，请参阅《管理评论与回复》。
• update — 使用 patch 语义更新一条回复。更多信息，请参阅《管理评论与回复》。

revisions

• delete — 永久删除某文件版本。仅支持删除 Google Drive 中二进制内容文件（如图片或视频）的修订版本；Google Docs、Sheets 等文档类型，以及文件的最后一个剩余版本，均不可删除。更多信息，请参阅《管理文件修订版本》。
• get — 根据 ID 获取某修订版本的元数据或内容。更多信息，请参阅《管理文件修订版本》。
• list — 列出某文件的所有修订版本。更多信息，请参阅《管理文件修订版本》。重要：对于具有大量修订历史的文件（例如频繁编辑的 Google Docs、Sheets 和 Slides），该方法返回的修订版本列表可能不完整；较早的修订版本可能被省略，因此响应中返回的第一个修订版本未必是现存最旧的修订版本。
• update — 使用 patch 语义更新某修订版本。更多信息，请参阅《管理文件修订版本》。

teamdrives

• create — 已弃用：请改用 drives.create。
• get — 已弃用：请改用 drives.get。
• list — 已弃用：请改用 drives.list。
• update — 已弃用：请改用 drives.update。

发现可用命令

调用任意 API 方法前，请先检查其定义：

# 浏览资源与方法列表
gws drive --help

# 查看某方法所需的参数、类型及默认值
gws schema drive..

请根据 gws schema 的输出构建您的 --params 和 --json 参数。