Google Workspace CLI (gws) — TATEKANOSファミリー横断活用方針
作成日: 2026-03-12
作成者: ClaudeCode(GeminiCLI調査結果を統合・文書化)
ステータス: Draft v0.1
参照記事: https://dev.classmethod.jp/articles/google-workspace-cli-release/
1. gws 概要
Google Workspace CLI(gws)は、GoogleのDiscovery Serviceを利用してGoogleの各種Workspace API(Gmail / Drive / Sheets / Chat等)をCLIコマンドから直接操作できるツール。
| 特徴 |
説明 |
| 動的API構築 |
Discovery Serviceで実行時にコマンドを構成。APIバージョンアップを自動吸収 |
| 構造化JSON出力 |
全レスポンスがJSONで返却 → スクリプト・AI解析が容易 |
| セキュアな認証 |
Service Account / Domain-Wide Delegation を標準サポート |
| AI親和性 |
MCP(Model Context Protocol)経由でAIエージェントが直接操作可能 |
| Agent Skills同梱 |
よく使われるワークフロー向けレシピ・スキルが付属 |
2. TATEKANOSファミリーにおける位置づけ
[TATEKANOS AI Agent Hub]
↓ MCP / CLIコマンド
[gws(Google Workspace CLI)]
↓
[Gmail] [Google Drive] [Google Sheets] [Google Chat]
↑ ↑ ↑ ↑
Mitsumori Toriteki TATEKAN Core 全システム
(発注メール) (証跡保存) (経営ダッシュ) (通知・アラート)
設計原則: gws は「GCPインフラ(Cloud Run / Pub/Sub等)とGoogle Workspace(社内ツール)をつなぐ糊(のり)」として活用する。イベント駆動のコアアーキテクチャ(Push通知 / Pub/Sub)は各システムの設計を維持し、gws はその内部処理・補助ツールとして組み込む。
3. Mitsumori(見積管理)への応用
詳細: docs/Tatekan/mitsumori/mitsumori_infra_design.md §12
| シナリオ |
gws コマンド |
優先度 |
| Marcury発注メール 本文・添付取得 |
gws gmail users messages get {messageId} |
Phase 1 |
| 処理済みラベル付与 |
gws gmail users messages modify --add-labels=MARCURY_PROCESSED |
Phase 1 |
| エスカレーション転送 |
gws gmail users messages send |
Phase 2 |
アーキテクチャ上の注意: Gmail API Push + Pub/Sub(常時待ち受け)は引き続き必要。gws はイベント発火後の処理ロジック(Cloud Run worker内)で使用する。
4. Toriteki(受発注・納品・検収進行)への応用
4.1 下請け業者からの成果物(納品書・報告書)自動回収
シナリオ: 下請け業者がToriteki画面を使わずメールに納品書PDFを添付して送信してきた場合。
# Cloud Run内でのイメージ
gws gmail users messages get --userId=me --id={messageId} \
--format=full | jq '.payload.parts[] | select(.mimeType=="application/pdf")'
# → 添付抽出 → GCS保存 → Toriteki納品ステータス自動更新
優先度: 高
4.2 やり直し依頼・エスカレーション自動化
シナリオ: 検収で不備があった場合、下請け業者へ修正依頼を送信。一定期間返信がない場合、社内マネージャーへエスカレーション。
# やり直し依頼メール送信
gws gmail users messages send --userId=me \
--subject="【要対応】検収不備について" --to={vendor_email}
# 返信チェック(定期バッチ)
gws gmail users messages list --userId=me \
--q="from:{vendor_email} after:{sent_date}" | jq '.resultSizeEstimate'
# → 0件なら Google Chat / メールでマネージャーへアラート
優先度: 中
4.3 発注書・検収書のセキュアな証跡保存(取適法・フリーランス新法対応)
シナリオ: 取引適正化法・フリーランス保護新法に対応するため、交付した書面をGoogle Driveに改ざん防止状態で長期保管。
# 指定フォルダへ保存(編集不可権限)
gws drive files create --name="発注書_{order_no}.pdf" \
--parents={ORDER_ARCHIVE_FOLDER_ID} --uploadType=multipart
# 閲覧のみ権限付与(改ざん防止)
gws drive permissions create --fileId={file_id} \
--role=reader --type=domain
優先度: 高(法令対応)
5. TATEKAN Core(案件・契約・売上・請求・会計連携)への応用
5.1 売上・請求データの経営ダッシュボード連携
シナリオ: 経営層・営業部門がBigQueryを直接叩かずにリアルタイムな売上実績をスプレッドシートで確認。
# BigQuery集計結果をスプレッドシートに日次出力
gws sheets spreadsheets values update \
--spreadsheetId={DASHBOARD_SHEET_ID} \
--range="売上実績!A1" --valueInputOption=RAW \
--values="$(bq query --format=json '...' | jq '[...]')"
優先度: 中(BIツール導入前の軽量ダッシュボードとして有効)
5.2 契約・請求アラートの自動化
シナリオ: 未入金の請求が一定日数経過 / 高額契約が発生した際、担当者・経理に自動通知。
gws gmail users messages send --userId=me \
--to={accountant_email} \
--subject="【未入金アラート】{client_name} {amount}円 {due_date}超過"
優先度: 低(TATEKAN Core実装後に検討)
5.3 請求書PDFのDrive自動分類・権限管理
シナリオ: 顧客に発行した請求書の控えを顧客別・年月別フォルダに自動整理し、経理担当者のみアクセス可能にする。
# 年月・顧客フォルダを動的作成
gws drive folders create --name="{YYYY-MM}_{client_code}" \
--parents={INVOICE_ROOT_FOLDER_ID}
# 請求書PDF保存
gws drive files create --name="請求書_{invoice_no}.pdf" \
--parents={folder_id}
# 経理グループにのみ閲覧権限
gws drive permissions create --fileId={file_id} \
--role=reader --type=group --emailAddress=keiri@godosangyo.com
優先度: 中
6. 実装優先度ロードマップ
| 優先度 |
システム |
シナリオ |
対応Issue |
| P1 |
Toriteki |
発注書・検収書 Drive証跡保存(取適法対応) |
本Issue |
| P1 |
Mitsumori |
Marcury発注メール 本文・添付取得 + ラベル |
#248 |
| P2 |
Toriteki |
下請け業者からの成果物自動回収 |
本Issue |
| P2 |
TATEKAN Core |
売上・請求データ → 経営スプレッドシート |
本Issue |
| P3 |
Toriteki |
やり直し依頼・エスカレーション自動化 |
本Issue |
| P3 |
TATEKAN Core |
請求書PDF Drive自動分類・権限管理 |
本Issue |
7. 技術的共通事項
7.1 認証設計
Service Account: gws-automation-sa@gobms-465809.iam.gserviceaccount.com
→ Domain-Wide Delegation 設定(Google Workspace 管理コンソール)
→ Impersonation: gems-admin@godosangyo.com
7.2 Cloud Run 内での使用方法
# Dockerfile への追加
RUN curl -sSL https://github.com/nicholasgasior/gws-cli/releases/latest/download/gws-linux-amd64 \
-o /usr/local/bin/gws && chmod +x /usr/local/bin/gws
# ※ 正式インストール方法は公式ドキュメントを参照
7.3 AIエージェント(ClaudeCode)との連携
MCP Server 経由で gws を直接操作可能:
- 開発・テスト時: ClaudeCodeがメール取得テスト・ラベル付与テストを自律実行
- QA自動化: Playwright MCP + gws を組み合わせたE2Eテスト
8. 未解決事項
- [ ] gws の正式インストール方法・Cloud Run対応バイナリの確認
- [ ] Domain-Wide Delegation の設定(Google Workspace 管理者権限が必要)
- [ ] 取適法対応 Drive フォルダ構造の詳細設計(保存期間・アクセス権限の法令要件確認)
- [ ] TATEKAN Core の実装スコープ確定後に優先度を見直し
本文書はGeminiCLI調査(2026-03-12)結果をClaudeCodeが統合・構造化して作成。