Drive、Gmail、日历和每个 Workspace API。零样板。结构化 JSON 输出。包含 40 多种特工技能。 > [!注意] > 这**不是**官方支持的 Google 产品。
⬇️ **[下载适合您操作系统的最新版本](https://github.com/googleworkspace/cli/releases)** `gws` 不提供静态命令列表。它在运行时读取 Google 自己的 [Discovery Service](https://developers.google.com/discovery) 并动态构建其整个命令界面。当 Google Workspace 添加 API 端点或方法时，“gws”会自动选择它。 > [!重要] > 该项目正在积极开发中。当我们迈向 v1.0 时，预计会有重大变化。 ## 内容 - [先决条件](#先决条件) - [安装](#安装) - [快速启动](#quick-start) - [为什么是 gws？](#why-gws) - [身份验证](#身份验证) - [AI代理技能](#ai-agent-skills) - [高级用法](#advanced-usage) - [环境变量](#environment-variables) - [退出代码](#exit-codes) - [架构](#architecture) - [疑难解答](#疑难解答) - [开发](#开发) ## 先决条件 - **Node.js 18+** — 用于“npm install”（或从 [GitHub Releases](https://github.com/googleworkspace/cli/releases) 下载预构建的二进制文件） - **Google Cloud 项目** — OAuth 凭据所需。您可以通过 [Google Cloud Console](https://console.cloud.google.com/) 或使用 [`gcloud` CLI](https://cloud.google.com/sdk/docs/install) 或使用 `gws auth setup` 命令创建一个。 - **可访问 Google Workspace 的 Google 帐户** ## 安装 安装“gws”的推荐方法是从 **[GitHub Releases](https://github.com/googleworkspace/cli/releases)** 页面下载适合您的操作系统和架构的预构建二进制文件。提取存档并将“gws”二进制文件放入“$PATH”中。 为了方便起见，您还可以使用 `npm` 自动从 GitHub Releases 下载适当的二进制文件： ````bash npm install -g @googleworkspace/cli ```` 或者从源代码构建： ````bash 货物安装 --git https://github.com/googleworkspace/cli --locked ```` Nix flake 也可以在 `github:googleworkspace/cli` 上找到 ````bash nix 运行 github:googleworkspace/