📋
Claude Codeなどに非公開のGoogle Spreadsheet/Docsをコンテキストとして楽にいれる
概要
Google Cloud の gcloud コマンドを使って、自分がアクセス権を持つ Google Spreadsheet / Google Docs の内容を CLI から取得する方法です。
TL;DR
# Spreadsheet (CSV)
curl -sL "https://docs.google.com/spreadsheets/d/${SPREADSHEET_ID}/export?format=csv&gid=${GID}" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"
# Docs (Markdown)
curl -s "https://www.googleapis.com/drive/v3/files/${DOCUMENT_ID}/export?mimeType=text/markdown" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"
手順
1. gcloud CLI のインストール
macOS
brew install --cask google-cloud-sdk
その他のOS
公式ドキュメントを参照してください。
2. Google アカウントでログイン
gcloud auth login
ブラウザが開くので、Google アカウントでログインしてください。
3. プロジェクトの作成
gcloud projects create "gdrive-api-$(openssl rand -hex 4)" --name="Google Drive API"
ランダムな文字列が付与されたプロジェクト(例:gdrive-api-4f51686d)が作成されます。
Google Cloud全体で一意である必要があるため、例ではランダムな文字列を生成させてますが、好みで変えてください。
4. プロジェクトの設定
作成したプロジェクトを使用するように設定します。
gcloud config set project gdrive-api-xxxxxxxx
gdrive-api-xxxxxxxx は手順3で作成されたプロジェクトIDに置き換えてください。
5. Google Drive へのアクセス権限を付与
gcloud auth login --enable-gdrive-access
再度ブラウザが開くので、アクセスを許可してください。
6. スプレッドシートの取得
curl -s "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" | jq
パラメータ:
-
SPREADSHEET_ID: スプレッドシートのURLから取得
https://docs.google.com/spreadsheets/d/【ここがID】/edit -
SHEET_NAME: シート名(タブ名)
シート名を確認する
curl -s "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" | jq '.sheets[].properties.title'
範囲を指定して取得
# A1からD10までを取得
curl -s "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}\!A1:D10" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" | jq
CSV形式でエクスポート
LLMに食わせる場合など、CSV形式が便利です。
curl -sL "https://docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/export?format=csv" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"
特定のシートを指定するには gid パラメータを追加:
curl -sL "https://docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/export?format=csv&gid={GID}" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"
パラメータ:
-
GID: シートのID(URLの#gid=xxxの部分)
7. Google Docs の取得
curl -s "https://docs.googleapis.com/v1/documents/{DOCUMENT_ID}" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" | jq
パラメータ:
-
DOCUMENT_ID: ドキュメントのURLから取得
https://docs.google.com/document/d/【ここがID】/edit
テキスト部分だけ抽出
curl -s "https://docs.googleapis.com/v1/documents/{DOCUMENT_ID}" \
-H "Authorization: Bearer $(gcloud auth print-access-token)" | jq -r '.body.content[].paragraph?.elements[]?.textRun?.content // empty'
Markdown形式でエクスポート
curl -s "https://www.googleapis.com/drive/v3/files/{DOCUMENT_ID}/export?mimeType=text/markdown" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"
HTML形式でエクスポート
curl -s "https://www.googleapis.com/drive/v3/files/{DOCUMENT_ID}/export?mimeType=text/html" \
-H "Authorization: Bearer $(gcloud auth print-access-token)"
補足
- この方法は自分がアクセス権を持つファイルのみ取得可能です
- あとはお好みでSkillsとかに書いてください
おまけ。導入するprompt例
以下の記事を参考に、user単位のClaude Code skillsを作成してください。
記事: https://zenn.dev/ux_xu/articles/2d171a94f32c60
要件:
- 公式のベストプラクティス(https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)に従う
- ~/.claude/skills/ に配置
FYI
Discussion