当前位置：首页 > news >正文

Google Workspace CLI高级教程：Drive文件批量操作与共享管理

news 2026/8/1 22:28:44

Google Workspace CLI高级教程：Drive文件批量操作与共享管理

【免费下载链接】cliGoogle Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.项目地址: https://gitcode.com/gh_mirrors/cli413/cli

Google Workspace CLI（命令行工具）是一款功能强大的命令行工具，可帮助用户通过命令行轻松管理Google Drive、Gmail、Calendar等Google Workspace服务。本教程将重点介绍如何使用Google Workspace CLI进行Drive文件的批量操作与共享管理，让您的工作效率提升10倍！

准备工作：安装与配置Google Workspace CLI

在开始使用Google Workspace CLI进行Drive文件操作之前，您需要先安装并配置好这个工具。

首先，通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/cli413/cli

然后，按照项目文档中的指引完成安装和认证过程。安装完成后，您可以通过运行gws --help命令来验证安装是否成功。

图1：Google Workspace CLI界面展示，显示了支持的各种Google服务

批量文件操作：高效管理Drive文件

Google Workspace CLI提供了丰富的命令来实现Drive文件的批量操作，包括文件列表、上传、创建和导出等功能。

1. 批量列出文件

使用gws drive files list命令可以列出Drive中的文件。通过添加参数，您可以实现更精确的筛选和批量处理。

例如，列出名称包含"Report"的文件：

gws drive files list --params '{"q": "name contains \"Report\"", "pageSize": 10}' --fields "files(id,name,mimeType)"

如果您需要处理大量文件，可以使用--page-all参数来获取所有文件：

gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'

2. 批量上传文件

使用gws drive +upload命令可以快速上传文件到Google Drive。您可以指定父文件夹ID和自定义文件名。

gws drive +upload ./report.pdf --parent FOLDER_ID --name 'Q1 Report.pdf'

对于批量上传，您可以编写简单的shell脚本循环处理多个文件：

for file in ./reports/*.pdf; do gws drive +upload "$file" --parent FOLDER_ID done

3. 批量创建文件夹

使用gws drive files create命令可以创建新的文件夹。结合shell脚本，您可以轻松创建复杂的文件夹结构。

gws drive files create --json '{"name": "Q2 Project", "mimeType": "application/vnd.google-apps.folder"}'

创建子文件夹：

gws drive files create --json '{"name": "Documents", "mimeType": "application/vnd.google-apps.folder", "parents": ["PARENT_FOLDER_ID"]}'

4. 批量导出文件

使用gws drive files export命令可以将Google Docs、Sheets等文件导出为其他格式。例如，将表格导出为CSV：

gws drive files export --params '{"fileId": "SHEET_ID", "mimeType": "text/csv"}' -o output.csv

对于批量导出，您可以先列出需要导出的文件，然后循环处理：

gws drive files list --params '{"q": "mimeType = '\''application/vnd.google-apps.spreadsheet'\''"}' --format json | jq -r '.files[].id' | while read id; do gws drive files export --params '{"fileId": "'"$id"'", "mimeType": "text/csv"}' -o "sheet_$id.csv" done

共享管理：灵活控制文件访问权限

Google Workspace CLI提供了强大的权限管理功能，让您可以轻松控制谁可以访问您的Drive文件。

1. 批量设置文件权限

使用gws drive permissions create命令可以为文件添加权限。您可以指定用户邮箱、角色（读者、评论者、编辑者）等。

gws drive permissions create --params '{"fileId": "FILE_ID"}' --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

要批量设置多个用户的权限，您可以创建一个包含用户邮箱和角色的CSV文件，然后使用脚本处理：

while IFS=, read -r email role; do gws drive permissions create --params '{"fileId": "FILE_ID"}' --json '{"role": "'"$role"'", "type": "user", "emailAddress": "'"$email"'"}' done < users.csv

2. 批量查看文件权限

使用gws drive permissions list命令可以查看文件的当前权限设置：

gws drive permissions list --params '{"fileId": "FILE_ID"}' --format table

3. 管理共享驱动器

Google Workspace CLI还支持管理共享驱动器（Shared Drives）。您可以创建共享驱动器、添加成员等：

# 创建共享驱动器 gws drive drives create --params '{"requestId": "unique-id-123"}' --json '{"name": "Project X"}' # 添加成员 gws drive permissions create --params '{"fileId": "DRIVE_ID", "supportsAllDrives": true}' --json '{"role": "writer", "type": "user", "emailAddress": "member@company.com"}'

高级技巧：结合其他工具实现自动化

Google Workspace CLI可以与其他命令行工具（如jq、xargs等）结合使用，实现更强大的自动化功能。

1. 使用jq处理JSON输出

jq是一个轻量级的命令行JSON处理器。您可以使用它来解析和处理Google Workspace CLI的JSON输出：

# 列出所有文件夹ID和名称 gws drive files list --params '{"q": "mimeType = '\''application/vnd.google-apps.folder'\''"}' --format json | jq -r '.files[] | .id + " " + .name'

2. 使用xargs进行批量操作

xargs命令可以将标准输入转换为命令行参数，非常适合批量处理：

# 批量删除文件（请谨慎使用） gws drive files list --params '{"q": "name contains '\''temp'\''"}' --format json | jq -r '.files[].id' | xargs -I {} gws drive files delete --params '{"fileId": "{}"}'

3. 创建自定义工作流

您可以创建复杂的shell脚本来实现自定义工作流。例如，以下脚本可以批量下载指定文件夹中的所有文件：

#!/bin/bash FOLDER_ID="your-folder-id" # 获取文件夹中的所有文件 FILES=$(gws drive files list --params '{"q": "'"$FOLDER_ID"' in parents"}' --format json) # 循环下载每个文件 echo "$FILES" | jq -r '.files[] | .id + " " + .name' | while read -r file_id file_name; do echo "Downloading $file_name..." gws drive files get --params '{"fileId": "'"$file_id"'", "alt": "media"}' -o "$file_name" done