AgentSkillsCN

auth-setup

指导Google OAuth客户端的配置流程。“OAuth配置”、“准备Google认证”、“创建客户端ID”、“讲解认证流程”、“准备Google登录”、“OAuth设置”、“想要进行认证配置”等指令均可触发。

SKILL.md
--- frontmatter
name: auth-setup
description: Google OAuth クライアント設定の手順を案内する。「OAuth 設定」「Google 認証の準備」「クライアント ID 作成」「認証手順を教えて」「Google ログイン準備」「OAuth セットアップ」「認証設定したい」などで起動。
allowed-tools: [Read]

Auth Setup

Google OAuth クライアント（デスクトップアプリ）の作成手順を案内します。

前提条件

bash
pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

手順

1. Google Cloud Console にアクセス

  1. •Google Cloud Console にアクセス
  2. •上部の「プロジェクトを選択」→「新しいプロジェクト」
  3. •プロジェクト名を入力（例: claude-code-plugins）して「作成」

2. API を有効化

メニュー → API とサービス → ライブラリ で以下を検索して有効化:

  • •Google Drive API
  • •Google Docs API
  • •Google Sheets API
  • •Google Slides API
  • •Google Forms API
  • •Apps Script API
  • •Google Calendar API
  • •Gmail API

3. OAuth 同意画面を設定

メニュー → Google Auth Platform → ブランディング

（「Google Auth Platform が設定されていません」と表示されたら「開始」をクリック）

  1. •

    アプリ情報

    • •アプリ名: 任意（例: Claude Code Plugins）
    • •ユーザーサポートメール: 自分のメールアドレス
    • •「次へ」
  2. •

    対象

    • •「外部」を選択
    • •「次へ」
  3. •

    連絡先情報

    • •メールアドレス: 自分のメールアドレス
    • •「次へ」
  4. •

    終了

    • •「Google API サービス: ユーザーデータに関するポリシー」に同意
    • •「続行」
  5. •

    テストユーザーを追加（重要）

    • •左メニューの「対象」をクリック
    • •「+ Add users」をクリック
    • •使いたい Google アカウントのメールアドレスを追加（複数可）

4. OAuth クライアント ID を作成

左メニュー → クライアント

  1. •「+ クライアントを作成」をクリック
  2. •アプリケーションの種類: デスクトップアプリ
  3. •名前: 任意（例: Claude Code）
  4. •「作成」
  5. •作成直後に JSON をダウンロード（後からダウンロードできない場合あり）

5. クライアント設定を配置

bash
mkdir -p ~/.config/shiiman-google/clients
mv ~/Downloads/client_secret_*.json ~/.config/shiiman-google/clients/default.json

6. 認証を実行

「Google ログインして」または「認証して」と言って認証を実行してください。

よくある質問

Q: OAuth クライアントは自動作成できる？

いいえ。セキュリティ上の理由で Google Cloud Console での手動作成が必須です。

Q: OAuth 以外の認証方法は？

個人の Google アカウントデータ（Gmail, Calendar 等）にアクセスするには OAuth が唯一の方法です。API キーやサービスアカウントでは個人データにアクセスできません。

Q: ドメインごとに OAuth クライアントが必要？

いいえ。1 つの OAuth クライアントで複数の Google アカウント（異なるドメイン含む）に対応できます。--profile オプションでアカウントを切り替えられます。

注意事項

  • •クライアント設定ファイル（default.json）には秘密情報が含まれています
  • •Git にコミットしないでください
  • •複数アカウントを使う場合は、プロファイル名を指定して認証できます