Google Docs 操作スキル (gog v0.10.0)
gog CLI で Google ドキュメントを操作する。
実行パス: gog
認証アカウント: (gogで認証したアカウント)
Execution Notes
execツールで実行時、timeout: 60を指定- ドキュメントIDは URL
https://docs.google.com/document/d/<docId>/editから取得可能
コマンドリファレンス
ドキュメント作成
gog docs create "<title>"
gog docs create "<title>" --parent "<folderId>" # 特定フォルダに作成
gog docs create "<title>" --file "./content.md" # Markdownファイルからインポートドキュメント情報取得
gog docs info <docId>
gog docs info <docId> --jsonドキュメント読み取り（プレーンテキスト）
gog docs cat <docId>
gog docs cat <docId> --tab "<tabTitle>" # 特定タブのみ
gog docs cat <docId> --all-tabs # 全タブ表示
gog docs cat <docId> --max-bytes 0 # 制限なし（デフォルト2MB）ドキュメント書き込み
# 末尾に追記（デフォルト）
gog docs write <docId> "追加テキスト"
gog docs write <docId> --file "./content.txt"
echo "テキスト" | gog docs write <docId> --file -
# 全体を置換
gog docs write <docId> "新しい内容" --replace
gog docs write <docId> --file "./content.md" --replace --markdownテキスト挿入（位置指定）
gog docs insert <docId> "挿入テキスト" --index 1 # 先頭に挿入
gog docs insert <docId> "挿入テキスト" --index 50 # 50文字目に挿入
gog docs insert <docId> --file "./snippet.txt" --index 1テキスト削除（範囲指定）
gog docs delete <docId> --start 1 --end 100検索置換
gog docs find-replace <docId> "検索文字列" "置換文字列"
gog docs find-replace <docId> "old" "new" --match-case # 大文字小文字区別ドキュメントコピー
gog docs copy <docId> "コピーのタイトル"
gog docs copy <docId> "コピーのタイトル" --parent "<folderId>"エクスポート（ダウンロード）
gog docs export <docId> # PDF（デフォルト）
gog docs export <docId> --format docx # Word形式
gog docs export <docId> --format txt # テキスト形式
gog docs export <docId> --format pdf --out "./out.pdf"タブ一覧
gog docs list-tabs <docId>
gog docs list-tabs <docId> --jsonコンテンツ更新（update）
gog docs update <docId> --content "新しい内容" # 全体置換
gog docs update <docId> --content "追加テキスト" --append # 末尾追記
gog docs update <docId> --content-file "./doc.md" --format markdown # Markdown変換出力オプション
| オプション | 説明 |
|---|---|
--json / -j | JSON出力 |
--plain / -p | TSV出力（パース向け） |
--results-only | JSON時、結果のみ出力 |
--select "field1,field2" | JSON時、フィールド絞り込み |
--dry-run / -n | 変更せず意図を表示 |
典型ワークフロー
新規ドキュメント作成→書き込み
# 1. 作成（IDを取得）
gog docs create "議事録 2026-02-15" --json
# 2. 内容を書き込み
gog docs write <docId> --file "./minutes.md" --replace --markdownドキュメント読み取り→編集
# 1. 内容確認
gog docs cat <docId>
# 2. テキスト置換
gog docs find-replace <docId> "旧プロジェクト名" "新プロジェクト名"エクスポート
# PDF出力
gog docs export <docId> --format pdf --out "./report.pdf"
# Word出力
gog docs export <docId> --format docx --out "./report.docx"テンプレートからコピー
# 1. テンプレートをコピー
gog docs copy <templateDocId> "新しいドキュメント" --json
# 2. プレースホルダーを置換
gog docs find-replace <newDocId> "{{NAME}}" "田中太郎"
gog docs find-replace <newDocId> "{{DATE}}" "2026年2月15日"タブ操作
# タブ一覧を確認
gog docs list-tabs <docId>
# 特定タブの内容を読む
gog docs cat <docId> --tab "Sheet1"
# 全タブの内容を一括表示
gog docs cat <docId> --all-tabs注意事項
- ドキュメントの一覧取得:
gog docsにはlist コマンドがない。Drive経由で検索する:gog drive ls --query "mimeType='application/vnd.google-apps.document'" - write のデフォルトは追記: 全体を書き換える場合は
--replaceを必ず付ける - Markdown変換:
--markdownは--replaceと併用が必要（write）。update では--format markdownを使う - insert の index: 1始まり。ドキュメント先頭は index=1
- delete の範囲:
--startと--endは必須。事前にcatで内容を確認してからインデックスを指定 - 大きなドキュメント:
catのデフォルト上限は2MB。--max-bytes 0で無制限 - 特殊文字: シェルエスケープに注意（引用符、改行など）
- 長い本文:
--fileオプションまたは stdin (--file -) を使う