name: gws-drive
description: Google Drive：管理文件、文件夹和共享云端硬盘。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws drive --help"

drive (v3)

前提条件： 阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果缺失，运行 gws generate-skills 创建。

gws drive <资源> <方法> [标志]

辅助命令

API 资源

about

• get — 获取关于用户、用户 Drive 及系统能力的信息。更多信息请参阅返回用户信息。必需：必须设置 fields 参数。要返回所需的确切字段，请参阅返回特定字段。

accessproposals

• get — 根据 ID 检索访问提议。更多信息请参阅管理待处理的访问提议。
• list — 列出文件上的访问提议。更多信息请参阅管理待处理的访问提议。注意：只有审批者才能列出文件上的访问提议。如果用户不是审批者，将返回 403 错误。
• resolve — 批准或拒绝访问提议。更多信息请参阅管理待处理的访问提议。

approvals

• get — 根据 ID 获取审批项。
• list — 列出文件上的审批项。

apps

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

changes

• getStartPageToken — 获取用于列出未来变更的起始 pageToken。更多信息请参阅检索变更。
• list — 列出用户或共享驱动器的变更。更多信息请参阅检索变更。
• watch — 订阅用户的变更。更多信息请参阅资源变更通知。

channels

• stop — 停止通过此频道监视资源。更多信息请参阅资源变更通知。

comments

• create — 在文件上创建评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的确切字段，请参阅返回特定字段。
• delete — 删除评论。更多信息请参阅管理评论和回复。
• get — 根据 ID 获取评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的确切字段，请参阅返回特定字段。
• list — 列出文件的评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的确切字段，请参阅返回特定字段。
• update — 使用补丁语义更新评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的确切字段，请参阅返回特定字段。

drives

• create — 创建共享驱动器。更多信息请参阅管理共享驱动器。
• get — 根据 ID 获取共享驱动器的元数据。更多信息请参阅管理共享驱动器。
• hide — 从默认视图中隐藏共享驱动器。更多信息请参阅管理共享驱动器。
• list — 列出用户的共享驱动器。此方法接受 q 参数，该参数是一个包含一个或多个搜索词的搜索查询。更多信息请参阅搜索共享驱动器指南。
• unhide — 将共享驱动器恢复为默认视图。更多信息请参阅管理共享驱动器。
• update — 更新共享驱动器的元数据。更多信息请参阅管理共享驱动器。

files

• copy — 创建文件的副本，并使用补丁语义应用任何请求的更新。更多信息请参阅创建和管理文件。
• 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。此方法支持补丁语义。此方法支持 */upload* URI 并接受上传的媒体，具有以下特性： - *最大文件大小：* 5,120 GB - *接受的媒体 MIME 类型：* */*（请指定有效的 MIME 类型，而不是字面值 */*。）
• watch — 订阅文件的变更。更多信息请参阅资源变更通知。

operations

• get — 获取长时间运行操作的最新状态。客户端可以使用此方法按照 API 服务建议的间隔轮询操作结果。

permissions

• create — 为文件或共享驱动器创建权限。更多信息请参阅共享文件、文件夹和驱动器。警告： 不支持对同一文件进行并发的权限操作；仅应用最后一次更新。
• delete — 删除权限。更多信息请参阅共享文件、文件夹和驱动器。警告： 不支持对同一文件进行并发的权限操作；仅应用最后一次更新。
• get — 根据 ID 获取权限。更多信息请参阅共享文件、文件夹和驱动器。
• list — 列出文件或共享驱动器的权限。更多信息请参阅共享文件、文件夹和驱动器。
• update — 使用补丁语义更新权限。更多信息请参阅共享文件、文件夹和驱动器。警告： 不支持对同一文件进行并发的权限操作；仅应用最后一次更新。

replies

• create — 创建对评论的回复。更多信息请参阅管理评论和回复。
• delete — 删除回复。更多信息请参阅管理评论和回复。
• get — 根据 ID 获取回复。更多信息请参阅管理评论和回复。
• list — 列出评论的回复。更多信息请参阅管理评论和回复。
• update — 使用补丁语义更新回复。更多信息请参阅管理评论和回复。

revisions

• delete — 永久删除文件版本。您只能删除 Google Drive 中具有二进制内容的文件（如图像或视频）的修订版本。其他文件（如 Google 文档或表格）的修订版本以及最后一个文件版本无法删除。更多信息请参阅管理文件修订。
• get — 根据 ID 获取修订的元数据或内容。更多信息请参阅管理文件修订。
• list — 列出文件的修订。更多信息请参阅管理文件修订。重要提示： 对于具有大量修订历史的文件（包括频繁编辑的 Google 文档、表格和幻灯片），此方法返回的修订列表可能不完整。较旧的修订可能从响应中省略，这意味着返回的第一个修订可能不是最早的现有修订。
• update — 使用补丁语义更新修订。更多信息请参阅管理文件修订。

teamdrives

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

发现命令

在调用任何 API 方法之前，请先检查它：

# 浏览资源和方法
gws drive --help

# 检查方法的必需参数、类型和默认值
gws schema drive.<资源>.<方法>

使用 gws schema 的输出构建您的 --params 和 --json 标志。