🚀 快速安装

复制以下命令并运行，立即安装此 Skill：

npx skills add https://github.com/googleworkspace/cli --skill gws-drive

💡 提示：需要 Node.js 和 NPM

drive (v3)

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

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

辅助命令

命令 描述
+upload 上传文件并自动添加元数据

API 资源

about

  • get — 获取有关用户、用户的云端硬盘以及系统功能的信息。有关更多信息，请参阅 返回用户信息。必需：必须设置 fields 参数。要返回您需要的确切字段，请参阅 返回特定字段。

accessproposals

approvals

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

apps

changes

  • getStartPageToken — 获取用于列出未来更改的起始 pageToken。有关更多信息，请参阅 检索更改。
  • list — 列出用户或共享云端硬盘的更改。有关更多信息，请参阅 检索更改。
  • watch — 订阅用户的更改。有关更多信息，请参阅 资源更改通知。

channels

  • stop — 停止通过此通道监视资源。有关更多信息，请参阅 资源更改通知。

comments

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，可在创建或复制请求中提供。有关更多信息，请参阅 创建和管理文件。
  • get — 按 ID 获取文件的元数据或内容。有关更多信息，请参阅 搜索文件和文件夹。如果您提供 URL 参数 alt=media，则响应正文中将包含文件内容。使用 alt=media 下载内容仅当文件存储在云端硬盘中时才有效。要下载 Google 文档、表格和幻灯片，请改用 files.export。
  • list — 列出用户的文件。有关更多信息，请参阅 搜索文件和文件夹。此方法接受 q 参数，它是一个组合了一个或多个搜索词的搜索查询。默认情况下，此方法返回 所有 文件，包括已删除的文件。如果您不希望已删除的文件出现在列表中，请使用 trashed=false 查询参数从结果中移除已删除的文件。
  • listLabels — 列出文件上的标签。有关更多信息，请参阅 列出文件上的标签。
  • modifyLabels — 修改应用于文件的一组标签。有关更多信息，请参阅 在文件上设置标签字段。返回已添加或修改的标签列表。
  • update — 更新文件的元数据、内容或两者。调用此方法时，仅填充您要修改的请求中的字段。更新字段时，某些字段可能会自动更改，例如 modifiedDate。此方法支持补丁语义。此方法支持 /upload URI 并接受上传的媒体，具有以下特征： – 最大文件大小： 5,120 GB – 接受的媒体 MIME 类型： */*（指定有效的 MIME 类型，而不是字面量 */* 值。）
  • watch — 订阅文件的更改。有关更多信息，请参阅 资源更改通知。

operations

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

permissions

replies

revisions

  • delete — 永久删除文件版本。您只能删除云端硬盘中具有二进制内容的文件（如图像或视频）的修订版本。其他文件（如 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 标志。

📄 原始文档

完整文档（英文）：

https://skills.sh/googleworkspace/cli/gws-drive

💡 提示：点击上方链接查看 skills.sh 原始英文文档，方便对照翻译。

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。