Google Workspace CLI: 究極の gws ツール
Google Workspace CLI: 究極の gws コマンドラインツール
Google は Workspace のパワーユーザーと AI 開発者向けにゲームチェンジャーをリリースしました: gws - ゼロボイラープレートで Google Workspace のすべての API をアンロックする単一の CLI。Drive のファイルから Gmail の自動化、Calendar のイベント、Sheets の操作まで、この Rust 駆動のビーストがすべてを扱います。
🚀 gws がすべてを変える理由
静的なコマンドリストを持つ従来の API クライアントとは異なり、gws はランタイムで Google の Discovery Service を読み込み、コマンドサーフェス全体を動的に構築します。Google が新しい API エンドポイントを追加すると、gws は自動的にそれらを検知します。REST ドキュメントを掘り起こしたり、curl の悪夢を書いたりする必要がなくなります。
主な機能: - Drive、Gmail、Calendar、Sheets、Chat、Admin - すべての Workspace API - 構造化された JSON 出力 - AI エージェントやスクリプティングに最適 - 40 以上の組み込みエージェントスキル - 一般的なワークフローのため - 自動ページネーション、dry-run、スキーマ内省 - npm 経由のクロスプラットフォームバイナリ (Rust ツールチェーン不要)
🎯 クイックスタート (2 分)
# グローバルインストール
npm install -g @googleworkspace/cli
# 認証設定
gws auth setup
gws auth login
# 最近の Drive ファイル一覧
gws drive files list --params '{"pageSize": 10}'
# スプレッドシート作成
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'
🤖 AI エージェント向けに構築
gws は 100 以上の Agent Skills (SKILL.md ファイル) を同梱しており、すべての API プラス Gmail レシピ、Drive 自動化などをカバーします。LLM と組み合わせれば、Workspace を自律的に管理できます:
# すべてのスキルをインストール
npx skills add https://github.com/googleworkspace/cli
# Gemini CLI 拡張
gemini extensions install https://github.com/googleworkspace/cli
🔐 多様な認証ワークフロー
- インタラクティブ:
gws auth login(暗号化された認証情報) - ヘッドレス/CI: インタラクティブセッションから認証情報をエクスポート
- サービスアカウント: JSON キー ファイルへのポインタ
- gcloud:
GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)
💎 プロ チップ
# すべてのファイルを NDJSON としてストリーミング
gws drive files list --page-all | jq -r '.files[].name'
# Chat メッセージの dry-run
gws chat spaces messages create --dry-run
# 任意のメソッドスキーマを内省
gws schema drive.files.list
# セキュアエージェントのための Model Armor 統合
gws gmail users messages get --sanitize "projects/P/locations/L/templates/T"
📦 インストールオプション
# npm (推奨 - バイナリ込み)
npm install -g @googleworkspace/cli
# Cargo
cargo install --git https://github.com/googleworkspace/cli --locked
# Nix
nix run github:googleworkspace/cli
⚠️ 重要な注意事項
- 積極的に開発中 - v1.0 に向けた破壊的変更に注意
- Google の公式サポート外 (ただし googleworkspace 組織から)
- 17.9k スター、32 人の貢献者、Apache-2.0 ライセンス
gws は単なる CLI ではなく、人間と AI エージェントのための Google Workspace 自動化の未来です。 今日インストールして、API ドキュメント探しの時代に別れを告げましょう。