google-workspace

Google Workspace スキル

概要

3つのアカウントでメール、カレンダー、ファイル、コミュニケーションを管理するための、Google Workspace 統合機能です。

エイリアス	用途	メール
psd	仕事	PSD の職場メール
kh	個人	個人用 Gmail
hrg	ビジネス	コンサルティングと不動産

アカウントの選択

明示的な指定

• 「psd のメールを確認して」
• 「hrg からメールを送信して」
• 「明日の kh のカレンダー」

文脈からの推測

Geoffrey は文脈から適切なアカウントを推測します：

• 仕事関連 → psd
• 個人的な用件 → kh
• ビジネス／不動産 → hrg

利用可能な操作

Gmail

スクリプト	説明	例
list_messages.js	受信トレイ、未読、ラベル別の一覧を表示	「未読の psd メールを表示して」
read_message.js	メッセージの全文を取得	「そのメールを読んで」
send_message.js	メールを作成して送信	「John に〜についてメールを送って」
send_with_attachment.js	ファイルを添付して送信	「PDF を添付してレポートをメールして」
search_messages.js	Gmail 演算子を使って検索	「先週 Sarah から届いたメールを探して」
get_unread_summary.js	未読件数と上位のメッセージを表示	「未読メールはいくつある？」

カレンダー

スクリプト	説明	例
list_events.js	今後の予定を取得	「今日のカレンダーには何がある？」
create_event.js	新しい予定を作成	「明日の午後2時に会議を予定して」
update_event.js	既存の予定を変更	「その会議を午後3時に移動して」
search_events.js	条件に一致する予定を検索	「Mike との会議を探して」

Drive

スクリプト	説明	例
list_files.js	ファイルを閲覧／検索	「予算のスプレッドシートを探して」
read_file.js	ファイルの内容を取得	「そのドキュメントを見せて」
create_file.js	新しいドキュメント／シートを作成	「新しいスプレッドシートを作成して」
upload_file.js	ローカルファイルをアップロード	「これを Drive にアップロードして」

タスク

スクリプト	説明	例
list_tasks.js	タスクリストを取得	「Google Tasks を表示して」
create_task.js	新しいタスクを追加	「Google Tasks にタスクを追加して」
complete_task.js	完了済みとしてマーク	「そのタスクを完了にして」

Chat

スクリプト	説明	例
list_spaces.js	利用可能なスペースを取得	「Chat のスペースを一覧表示して」
send_message.js	スペースに投稿	「チームのチャットにメッセージを送って」
read_messages.js	チャット履歴を取得	「最近のチャットメッセージを表示して」

使用パターン

スクリプトの実行

すべてのスクリプトは認証に token_manager を使用します：

const { getAuthClient } = require('./auth/token_manager');

async function main() {
  const account = process.argv[2] || 'psd';
  const auth = await getAuthClient(account);

  // Use auth with Google API
  const gmail = google.gmail({ version: 'v1', auth });
  // ...
}

出力形式

すべてのスクリプトは JSON を返します：

{
  "success": true,
  "account": "psd",
  "data": { ... },
  "metadata": {
    "timestamp": "2024-01-15T10:30:00Z",
    "count": 5
  }
}

エラー処理

{
  "error": "Token expired",
  "account": "psd",
  "action": "Run: node token_manager.js refresh psd"
}

必要なセットアップ

このスキルを使用する前に：

1. Google Cloud Console のセットアップを完了します（auth/GOOGLE_CLOUD_SETUP.md を参照）
2. 認証情報を ~/Library/Mobile Documents/com~apple~CloudDocs/Geoffrey/secrets/.env に追加します
3. 3つすべてのアカウントを認証します
4. PSD アカウントの場合：Google Admin で OAuth アプリを許可リストに追加します

アカウント間の操作

一部の操作は複数のアカウント間で実行できます：

• 「これを個人用メールに転送して」
• 「このファイルを仕事用の Drive にコピーして」
• 「両方のカレンダーに追加して」

Gmail 検索演算子

標準的な Gmail 検索に対応しています：

• from: - 送信者
• to: - 宛先
• subject: - 件名
• has:attachment - 添付ファイルあり
• after: / before: - 日付範囲
• is:unread - 未読のみ
• label: - ラベル別

例：「from:[email protected] after:2024-01-01 has:attachment で psd のメールを検索して」

注意事項

• アクセストークンの有効期限は1時間です（自動更新されます）
• 取り消されない限り、リフレッシュトークンの有効期限はありません
• すべての API 呼び出しには Google によるレート制限があります
• Keep の利用可能範囲は限られています（有効になっていない場合があります）