gws-drive · 按范围盘点云盘文件和共享权限

先看看示例

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

输出

方法说明

找出指定目录中的文件、版本与可见权限，区分可读取元数据和真正能下载的内容。

具体任务

盘点一个文件范围：按文件夹或查询条件列文件ID、类型和回收站状态，说明分页覆盖。

检查一份文件的共享对象：读取权限并整理可见对象与角色，为授权调整提供审阅材料。

必需材料

目标文件夹/文件ID或明确查询条件

需要盘点的字段、是否含回收站以及可用账号范围

可选材料

共享权限或版本历史的核查目标

导出格式与下载目录

使用门槛

能区分文件ID与显示名称，并拥有相应Drive读取权限；修改共享或删除版本需要单独权限。

这个 Skill 额外提供的方法

盘点时同时约束查询、分页和所需字段，再按文档类型选择导出路径，减少漏文件和误判权限历史。

编辑示例（未运行）

同名文件要按ID区分

任务：从目录返回值整理有效文件清单

输入：
编辑返回值：F1名为预算、类型Google Sheets、trashed=false；F2名为预算、类型PDF、trashed=false；F3名为旧预算、类型PDF、trashed=true。需求为不含回收站的文件清单；单页已明确无nextPageToken。

结果片段：
| 文件ID | 名称 | 类型 | 纳入本次清单 |
|---|---|---|---|
| F1 | 预算 | Google Sheets | 是，导出方式另行确认 |
| F2 | 预算 | PDF | 是，与F1不是同一文件 |
| F3 | 旧预算 | PDF | 否，位于回收站 |

本返回范围内有效文件2个；未提供权限记录，因此不判断谁可以访问，也没有下载文件。

这是编辑整理的虚构API返回数据，不代表真实云盘检索或下载结果。

首次任务

请使用已安装的 gws-drive Skill。
任务：盘点一个文件范围。
按文件夹或查询条件列文件ID、类型和回收站状态，说明分页覆盖。

必需材料：
- 目标文件夹/文件ID或明确查询条件：[填写或粘贴我的实际材料]
- 需要盘点的字段、是否含回收站以及可用账号范围：[填写或粘贴我的实际材料]

可选材料：
- 共享权限或版本历史的核查目标：[有则补充；缺失时不要假定存在]
- 导出格式与下载目录：[有则补充；缺失时不要假定存在]

处理边界：files.list默认包含回收站文件，必须按任务明确是否排除；同名文件不能仅凭名称合并。；Google Workspace文档导出与普通文件媒体下载不同，源入口注明export有大小限制。。先指出影响任务的材料缺口；没有实际执行的操作和测试不要写成已完成。

请按以下标准交付可审阅结果：
1. 文件以ID去重，同名不同ID保留。
2. 查询条件、回收站口径与分页完成情况可核对。
3. 权限、版本和内容下载各自有实际证据，不从元数据推断全部可访问。

验收方法

文件以ID去重，同名不同ID保留。

查询条件、回收站口径与分页完成情况可核对。

权限、版本和内容下载各自有实际证据，不从元数据推断全部可访问。

依赖与准备

需要gws、完整gws-drive及gws-shared，上传辅助入口另需gws-drive-upload。真实操作依赖文件/共享云盘权限和API配额；生成查询可用本地dry-run，读取或导出仍会访问Google服务。

使用边界

files.list默认包含回收站文件，必须按任务明确是否排除；同名文件不能仅凭名称合并。

Google Workspace文档导出与普通文件媒体下载不同，源入口注明export有大小限制。

同文件权限修改不支持并发操作；版本列表可能不完整，不能把最早返回项当作首个历史版本。

本站示例由编辑撰写，未运行上游 Skill，不代表平台已完成工具兼容认证。

排错

盘点数量比界面多：检查是否把回收站文件或其他可见范围包括进来。

权限改动互相覆盖：停止对同一文件并行写权限，按批准顺序逐项修改并回读。

固定来源

https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/skills/gws-drive/SKILL.md

许可

Apache-2.0。许可原文：https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/LICENSE

仓库热度

googleworkspace/cli 仓库 31,208 Stars（2026-09-30 核验）；这是父仓库指标，不是单个 Skill 的评分。