Google Workspace CLI
通过命令行自动化管理 Google Workspace 的终端工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Google Workspace CLI。 它的用途是：通过命令行自动化管理 Google Workspace 的终端工具 完整的 Skill 内容见：https://321skill.com/skills/google-workspace-cli-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我用 gws 搜索过去一周所有包含“项目报告”附件的邮件，并将结果导出为CSV文件。’，它会指导你运行类似 `gws gmail search --query 'has:attachment 项目报告 newer_than:7d' --output csv > reports.csv` 的命令。或者，当你说‘需要批量给市场部的所有成员分享一个Google Drive文件夹的编辑权限’，AI会建议使用 `gws drive share --file-id <文件ID> --role writer --group market-dept@company.com` 命令来实现。
介绍
Google Workspace CLI 是一款专为终端设计的命令行工具，旨在解决开发者和 IT 管理员在自动化处理 Google Workspace 服务时遇到的 API 调用复杂、错误处理繁琐等问题。它封装了超过 20 个 Google API，让你无需编写复杂的 OAuth 流程或处理各种 API 错误，就能直接通过 gws 命令完成批量邮件搜索与发送、文件共享与导出、日历事件管理、用户与群组管理等操作。
使用时，你只需在终端中配置好服务账号凭据，即可通过直观的命令行参数执行各种操作，例如批量搜索 Gmail 邮件、将 Google Drive 文件导出为指定格式、管理 Calendar 日程，或通过 Admin SDK 管理用户。当你的自定义脚本因 403、invalid_grant、配额错误或空结果而失败时，gws 提供了更稳定、更易用的替代方案。
这个工具非常适合需要将 Google Workspace 操作集成到自动化脚本、CI/CD 流程，或需要构建 MCP（Model Context Protocol）工具来暴露 Workspace 功能的开发者。它尤其能帮助后端开发、运维工程师和系统管理员提升日常工作效率。
需要注意的是，gws 专注于 Google Workspace（如 Gmail, Drive, Calendar, Sheets, Docs, Admin SDK），不适用于管理 Google Cloud 基础设施（那是 gcloud 的范畴），也不能用于本地 macOS 邮件或日历应用。初次使用前，请确保已在 Google Cloud Console 创建项目并启用相应 API，准备好服务账号密钥。
核心特点
与通用的 Google API 客户端库相比，它直接封装了复杂的 OAuth 流程和错误处理，提供开箱即用的命令行接口，特别针对 API 调用失败（如 403、配额错误）和空结果等场景进行了优化，并能轻松将 Workspace 操作暴露为 MCP 工具。
注意事项
不适用于管理 Google Cloud 基础设施（如 Compute Engine, Cloud Storage）或操作本地 macOS 的邮件和日历应用。
常见问题
gws 和 gcloud 有什么区别？
gws 专门用于自动化 Google Workspace 服务（如 Gmail, Drive, Calendar），而 gcloud 用于管理 Google Cloud 平台的基础设施（如虚拟机、存储桶）。
当 Google API 调用返回 403 错误时，gws 能做什么？
gws 内置了更友好的错误处理和重试机制，可以帮助你诊断权限问题，并提供更简单的服务账号认证方式，避免复杂的 OAuth 流程。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x/raw/index.md（查看排版版本）