a69b9d9160
Permission-first AI agent runtime for Google Workspace. Ports the LARC/OpenClaw governance model (disclosure chain, execution gates, queue/ingress) to Gmail, Calendar, Drive, Sheets, Tasks, and People APIs with Claude Code as the execution engine. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
80 lines
3 KiB
Markdown
80 lines
3 KiB
Markdown
# Google Cloud Console セットアップガイド
|
||
|
||
## 有効化するAPI一覧
|
||
|
||
Google Cloud Console (https://console.cloud.google.com/) で以下を有効化してください。
|
||
|
||
### 必須 API（6種）
|
||
|
||
| API名 | サービス名 | 用途 |
|
||
|-------|-----------|------|
|
||
| **Google Drive API** | `drive.googleapis.com` | ファイル読み書き・開示チェーン |
|
||
| **Google Sheets API** | `sheets.googleapis.com` | メモリ・エージェント台帳・キュー |
|
||
| **Gmail API** | `gmail.googleapis.com` | メール送受信・承認通知 |
|
||
| **Google Calendar API** | `calendar-json.googleapis.com` | 予定管理・会議調整 |
|
||
| **Google Tasks API** | `tasks.googleapis.com` | タスク管理 |
|
||
| **Google Docs API** | `docs.googleapis.com` | ドキュメント作成・編集 |
|
||
|
||
### 推奨 API（2種）
|
||
|
||
| API名 | サービス名 | 用途 |
|
||
|-------|-----------|------|
|
||
| **Google People API** | `people.googleapis.com` | 連絡先・組織メンバー検索 |
|
||
| **Google Chat API** | `chat.googleapis.com` | Chatボット・スペースへの送信 |
|
||
|
||
---
|
||
|
||
## 有効化手順
|
||
|
||
1. https://console.cloud.google.com/ にアクセス
|
||
2. 上部のプロジェクト選択で **新しいプロジェクト** を作成（または既存を選択）
|
||
3. 左メニュー → **「APIとサービス」** → **「APIとサービスを有効化」**
|
||
4. 検索ボックスに上記のAPI名を入力 → **「有効にする」**
|
||
|
||
---
|
||
|
||
## OAuth2 認証情報の作成
|
||
|
||
1. **「APIとサービス」** → **「認証情報」**
|
||
2. **「認証情報を作成」** → **「OAuth 2.0 クライアント ID」**
|
||
3. アプリケーションの種類: **「デスクトップアプリ」**
|
||
4. 名前: `GARC CLI` など任意
|
||
5. 作成後 **「JSONをダウンロード」** → `~/.garc/credentials.json` に保存
|
||
|
||
---
|
||
|
||
## OAuth同意画面の設定
|
||
|
||
1. **「APIとサービス」** → **「OAuth 同意画面」**
|
||
2. ユーザーの種類: **「外部」**（個人Gmailの場合）または **「内部」**（Workspace組織の場合）
|
||
3. アプリ名: `GARC` など
|
||
4. **テストユーザー** に自分のGmailアドレスを追加
|
||
5. スコープは空でOK（CLIが実行時に要求します）
|
||
|
||
---
|
||
|
||
## サービスアカウント（ボット操作用・任意）
|
||
|
||
自動化・ヘッドレス実行には Service Account が推奨：
|
||
|
||
1. **「認証情報」** → **「認証情報を作成」** → **「サービスアカウント」**
|
||
2. 名前: `garc-bot` など
|
||
3. 作成後、サービスアカウントの **「キー」** タブ → **「鍵を追加」** → **「JSON」**
|
||
4. ダウンロードしたJSONを `~/.garc/service_account.json` に保存
|
||
5. 使用するDriveフォルダ・SheetsをサービスアカウントのメールアドレスにShare
|
||
|
||
---
|
||
|
||
## 確認用コマンド
|
||
|
||
APIを有効化してcredentials.jsonを配置したら：
|
||
|
||
```bash
|
||
garc auth login --profile backoffice_agent
|
||
# → ブラウザが開いてGoogleログイン画面
|
||
# → 全スコープを承認
|
||
# → ~/.garc/token.json が生成される
|
||
|
||
garc status
|
||
# → 全項目が ✅ になることを確認
|
||
```
|