Google Workspace CLI
Google Workspace (googleworkspace GitHub organization) · 程式設計
Google Workspace CLI，幾乎所有人都叫它 gws，是一款免費的開源命令列工具，把 Drive、Gmail、Calendar、Sheets、Docs、Chat 與 Admin 收在單一介面之後，讓你再也不必碰網頁介面。你不必照著 REST 文件手寫 curl 呼叫，只要執行一個指令，就能拿回結構化的 JSON。它同時為兩種對象打造：想快速為 Workspace 寫腳本的開發者，以及需要機器可讀輸出與現成技能的 AI 代理。這樣的定位說明了它的許多設計。
關於 Google Workspace CLI
什麼是 Google Workspace CLI
Google Workspace CLI 是來自 googleworkspace GitHub 組織、以 Rust 打造的工具，把每一項 Google Workspace API 包進同一個執行檔。巧妙之處在於它並沒有內建固定的指令清單。它在執行時讀取 Google 的 Discovery Service，即時建立指令介面，所以當 Google 新增一個 API 端點時，gws 不必更新就能接上。輸出預設為結構化 JSON，這讓它對腳本或 LLM 的用處，跟對坐在終端機前的人一樣大。
這個專案的目標對象，是整天泡在 Workspace 裡、想擺脫點擊網頁介面的人，加上日益增加、把 AI 助理接進日常商務工具的開發者。你只要用 OAuth 驗證一次，就能在單一 shell 裡列出檔案、建立試算表、傳送 Chat 訊息或抓取日曆事件。它還內建約 40 個 AI 代理技能，讓助理不必打造自訂工具就能處理 Workspace 任務。完全不用黏合程式碼。
一個重要的提醒：這並非 Google 官方支援的產品。它正在積極開發中，維護者也警告，在邁向 1.0 版的路上應預期會有破壞性變更。那你該在意嗎？如果你的腳本需要長期穩定，答案是會。它採用 Apache-2.0 授權，而且你需要自己的 Google Cloud 專案來取得 OAuth 憑證。想要打磨完善、保證穩定的工具，這款不是。想要一款推進快速、能觸及每一項 Workspace API 的工具，則很難被超越。取捨由你決定。
開始使用
- 安裝 Node.js 18 或更新版本，或從 GitHub Releases 頁面取得適用於你作業系統的預編譯執行檔。
- 用
npm install -g @googleworkspace/cli安裝 gws，或在 macOS 上使用 Homebrew。 - 執行
gws auth setup，逐步完成 Google Cloud 專案設定與 OAuth 憑證。 - 用
gws auth login登入一個具有 Workspace 存取權的 Google 帳戶。 - 試一個真實指令，例如列出你最近十個 Drive 檔案，並檢查 JSON 回應。
產品資訊
快速了解 Google Workspace CLI 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 為 Workspace 任務寫腳本的開發者：gws 移除了原始 REST 呼叫的樣板程式碼。你得先準備好 Google Cloud 專案與 OAuth 憑證。
- AI 代理開發者：結構化 JSON 輸出加上內建的 40 個代理技能，讓 LLM 不必自訂整合就能管理 Drive、Gmail 與 Calendar。
- 系統管理員與 IT 人員：透過單一執行檔存取 Admin API，簡化了整個工作區的自動化，前提是你握有正確的帳戶權限。
任務
- 自動化 Drive 檔案操作：用 shell 指令而非網頁介面來列出、搜尋與管理檔案。
- 在 Sheets 產生報表：以程式化方式建立試算表並推送資料，用於排程報表。
- 從腳本傳送 Chat 或 Gmail 訊息：在更大的自動化流程中觸發通知或電子郵件。
情境
- 把 Workspace 接進 CI/CD 流程：在組建步驟旁執行 Drive 或 Sheets 指令。
- 打造能依要求安排會議或歸檔文件的個人助理。
- 跨多個帳戶與共用雲端硬碟進行大量工作區管理。
主要功能
從 Discovery Service 即時建立的指令介面
這款 CLI 並不把指令寫死。它在執行時讀取 Google 的 Discovery Service，所以每一項 Workspace API 端點與方法都會自動變成可用指令。當 Google 推出新端點，你不必等 gws 發版就能取得。這正是靜態封裝工具做不到、能讓它保持最新的原因。就是這麼簡單。
為代理而生的結構化 JSON 輸出
每個回應都以結構化 JSON 回傳。對人類而言，這代表可預測、能解析的輸出，可以接進 jq 或腳本。對 AI 代理而言，這代表 LLM 不必任何黏合程式碼就能讀取並操作 Workspace 資料。這正是它同時向代理開發者與一般人推銷的核心原因。輸出始終乾淨。
內建的 AI 代理技能
專案隨附約 40 個代理技能，涵蓋常見的 Workspace 工作流程。你不必從頭撰寫工具定義，就能把它們放進代理，讓它處理 Drive、Gmail 或 Calendar 任務。這縮短了從「我有個 LLM」到「我的 LLM 能管理我的 Workspace」的路徑。一大捷徑。
內建說明、試跑與自動分頁
每一項資源都支援 --help，所以你不用離開終端機就能探索指令。--dry-run 旗標會在請求送出前預覽，當你在摸索不熟悉的端點時很方便。自動分頁則處理大量結果集，讓你不必為逐批翻過數百個 Drive 檔案或 Gmail 訊息而寫迴圈邏輯。
橫跨所有 Workspace 服務的單一介面
Drive、Gmail、Calendar、Sheets、Docs、Chat 與 Admin 全都在同一套指令結構之後。你學會這個模式一次，就能套用到各處，這減少了在數個 SDK 之間切換所帶來的脈絡轉換。一次登入就能涵蓋整個介面。重點就在這裡。
跨平台安裝選項
你可以透過 npm、Homebrew、Cargo 或 Nix flake 安裝 gws，或直接下載適用於你作業系統的預編譯執行檔。這樣的彈性讓它能融入大多數開發環境，不論是 Mac 筆電、Linux 伺服器或 Windows 機器。
優缺點
優點
- 以 Apache-2.0 授權免費開源，沒有付費層級要操心。
- 透過單一一致的介面涵蓋每一項 Google Workspace API。
- 即時的 Discovery Service 整合讓指令集保持最新，使 Google Workspace 自動化更容易維護。
- JSON 輸出與內建代理技能，讓它對 AI 代理工作流程真正有用。
- 多種安裝途徑（npm、Homebrew、Cargo、Nix、預編譯執行檔）幾乎適用於任何環境。
缺點
- 並非 Google 官方支援的產品，所以沒有正式的 Google 支援承諾。
- 1.0 版之前預期會有破壞性變更，意味著發版後腳本可能需要更新。
- 設定需要你自己的 Google Cloud 專案與 OAuth 設定，對非開發者是一道真實的門檻。
常見問題
是的。它以 Apache-2.0 授權開源，完全免費。你確實需要一個 Google 帳戶，以及用於 OAuth 的 Google Cloud 專案，但對一般個人或開發者用途來說，兩者都不收費。
相關內容
探索與 Google Workspace CLI 相關的工具、技能與文章。
Google Workspace CLI 替代方案
Forefront
Forefront · 程式設計Forefront 是一個用來打造開源 AI 的網頁平台。你可以用自己的資料微調主流的開源語言模型、評估它們的表現，再透過 API 執行，或匯出後自行架設。想要封閉式平台的便利、卻堅持要自己擁有模型與資料的開發者，就是這裡的目標客群。
Startkit
StartKit.AI · 程式設計Startkit 是一套用來打造 AI SaaS 與 AI 包裝產品的樣板。可以把它想成一個 AI 新創樣板，把枯燥的部分都先接好了：驗證、Stripe 與 Lemon Squeezy 付款、用量限制、交易型電子郵件，以及一套能與 OpenAI、Anthropic、Groq 或 Llama 溝通的 AI API 啟動套件。你複製儲存庫、設定價格，然後專心在產品中使用者真正願意付費的部分。它建構於 React 與 Tailwind 之上的 Next.js，所以大部分的樣板程式碼對你來說並不陌生。
Testim
Tricentis · 程式設計Testim 是專為網頁、行動與 Salesforce 應用程式打造的 AI 測試自動化平台，用來建立並執行端到端測試。它靠機器學習在介面變動時維持測試穩定，團隊因此少花時間修補壞掉的定位器。對於一款今天就能開始使用的自動化測試工具來說，這表現不算差。你透過在瀏覽器錄製動作來建立測試，需要更多控制時再補上 JavaScript。對忙碌的 QA 團隊來說，這是個可靠的選擇。