🔧 技術調査 - Google Workspace CLI

npm install -g @googleworkspace/cli

git clone https://github.com/googleworkspace/cli
cd cli
cargo install --path .

cargo build               # 開発ビルド
cargo clippy -- -D warnings  # リント
cargo test                # ユニットテスト

gws auth setup   # 初回のみ
gws auth login   # 2回目以降

# 認証済みマシンでエクスポート
gws auth export --unmasked > credentials.json

# ヘッドレスマシンで利用
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json
gws drive files list

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
export GOOGLE_WORKSPACE_CLI_IMPERSONATED_USER=admin@example.com
gws drive files list

gws <service> <resource> [sub-resource] <method> [flags]

gws --help
gws drive --help
gws drive files --help
gws drive files list --help

# ファイル一覧（フィールド絞り込み）
gws drive files list --params '{"pageSize": 10}' --fields "files(id,name,mimeType)"

# ファイル検索
gws drive files list --params '{"q": "name contains \"Report\"", "pageSize": 10}'

# ファイルアップロード（ヘルパー）
gws drive +upload ./report.pdf --parent FOLDER_ID

# ファイルダウンロード
gws drive files get --params '{"fileId": "FILE_ID", "alt": "media"}' --output ./downloaded.pdf

# フォルダ作成
gws drive files create --json '{"name": "Project Files", "mimeType": "application/vnd.google-apps.folder"}'

# 権限付与
gws drive permissions create \
  --params '{"fileId": "FILE_ID"}' \
  --json '{"role": "reader", "type": "user", "emailAddress": "user@example.com"}'

# 全件ページネーション
gws drive files list --params '{"pageSize": 100}' --page-all | jq -r '.files[].name'

# メール送信（ヘルパー）
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'

# 受信トレイのトリアージ
gws gmail +triage --max 5 --query 'from:boss'

# メッセージ検索
gws gmail users messages list --params '{"userId": "me", "q": "is:unread"}'

# メッセージ取得
gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}'

# 直近のイベント表示（ヘルパー）
gws calendar +agenda
gws calendar +agenda --week --format table

# イベント作成（ヘルパー）
gws calendar +insert \
  --summary 'Team Standup' \
  --start '2024-06-17T09:00:00-07:00' \
  --end '2024-06-17T09:30:00-07:00' \
  --attendee alice@example.com

# スプレッドシート作成
gws sheets spreadsheets create --json '{"properties": {"title": "Q4 Budget"}}'

# 範囲の値を取得
gws sheets spreadsheets values get \
  --params '{"spreadsheetId": "ID", "range": "Sheet1!A1:C10"}'

# 行を追記（ヘルパー）
gws sheets +append --spreadsheet SHEET_ID --range 'Sheet1!A:C' --values '["col1","col2"]'

# ドキュメント作成
gws docs documents create --json '{"title": "Meeting Notes"}'

# テキスト追記（ヘルパー）
gws docs +write --document DOC_ID --text 'Hello, world!'

# スペース一覧
gws chat spaces list

# メッセージ送信（ヘルパー）
gws chat +send --space spaces/AAAAxxxx --text 'Hello team!'

# メッセージ送信（dry-run 付き）
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Deploy complete."}' \
  --dry-run

gws gmail +send --to bob@example.com --subject "Notes" --body "Here are the notes..."
gws gmail +send --to bob@example.com --subject "HTML" --body "<b>Hello</b>" --html
gws gmail +triage --query 'label:support' --max 50

gws drive +upload ./report.pdf
gws drive +upload ./data.csv --parent FOLDER_ID --name "Sales Data Q1.csv"

gws calendar +agenda
gws calendar +agenda --week --format table
gws calendar +insert --summary "Standup" --start "2026-06-17T09:00:00-07:00" --end "2026-06-17T09:30:00-07:00" --attendee alice@example.com

gws workflow +standup-report --format table
gws workflow +meeting-prep
gws workflow +email-to-task --message-id MSG_ID
gws workflow +weekly-digest --format table
gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123

gws schema drive.files.list
gws schema drive.File --resolve-refs

# 全スキルのインストール
npx skills add https://github.com/googleworkspace/cli

# 特定サービスのスキルのみインストール
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive

# Gemini CLI 拡張機能として利用
gemini extensions install https://github.com/googleworkspace/cli

{
  "mcpServers": {
    "gws": {
      "command": "gws",
      "args": ["mcp"]
    }
  }
}

skills/
  gws-drive/         # Drive 操作スキル
  gws-gmail/         # Gmail 操作スキル
  gws-calendar/      # Calendar 操作スキル
  gws-sheets/        # Sheets 操作スキル
  gws-admin/         # Admin 操作スキル
  ...

# 全ページを自動取得（NDJSON 形式で出力）
gws drive files list --page-all

# ページ数を制限して取得
gws drive files list --page-all --page-limit 5 --page-delay 200

gws drive files list --format table
gws drive files list --format csv
gws drive files list --format yaml

# コマンドごとに指定
gws gmail users messages get \
  --params '{"userId": "me", "id": "MSG_ID"}' \
  --sanitize "projects/PROJECT/locations/LOCATION/templates/TEMPLATE"

# 環境変数でデフォルト設定
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws sheets spreadsheets create \
  --json '{"properties": {"title": "Q1 Budget"}}' \
  --dry-run

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

# メソッドのスキーマを確認
gws schema drive.files.list

# リソース型のスキーマを確認
gws schema drive.File

# $ref を再帰的に解決
gws schema drive.File --resolve-refs

gws sheets spreadsheets values get \
  --params '{"spreadsheetId": "ID", "range": "Sheet1!A1:C10"}'

gws drive files list --page-all --page-limit 20

export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws auth login --scopes drive,gmail,calendar

export GOOGLE_WORKSPACE_CLI_LOG=gws=debug
gws drive files list

gws --help                                    # 利用可能なサービス一覧
gws drive --help                              # サービス配下のリソース一覧
gws drive files --help                        # リソース配下のメソッド一覧
gws drive files list --help                   # メソッドのパラメータ詳細