Google Drive 操作スキル (gog v0.10.0)
gog CLI でGoogleドライブを操作する。
実行パス: gog
認証アカウント: (gogで認証したアカウント)
Execution Notes
execツールで実行時、timeout: 60を指定- 大きなファイルのアップロード/ダウンロードは
timeout: 300推奨
ファイル一覧
ルートフォルダ
gog drive ls
gog drive ls --max 20特定フォルダ
gog drive ls --parent <folderId>詳細出力
gog drive ls --jsonファイル検索
テキスト検索
gog drive search "レポート"
gog drive search "プロジェクト計画"高度な検索（Driveクエリ構文）
# ファイルタイプで絞り込み
gog drive search "mimeType='application/pdf'"
gog drive search "mimeType='application/vnd.google-apps.spreadsheet'"
gog drive search "mimeType='application/vnd.google-apps.document'"
# 特定フォルダ内
gog drive search "name contains '請求書' and '<folderId>' in parents"
# 所有者
gog drive search "name contains 'report' and 'user@example.com' in owners"MIMEタイプ一覧
| タイプ | MIMEタイプ |
|---|---|
application/pdf | |
| Googleスプレッドシート | application/vnd.google-apps.spreadsheet |
| Googleドキュメント | application/vnd.google-apps.document |
| Googleスライド | application/vnd.google-apps.presentation |
| フォルダ | application/vnd.google-apps.folder |
| 画像 | image/jpeg, image/png |
| Word | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
| Excel | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
ファイル操作
メタデータ取得
gog drive get <fileId>ダウンロード
gog drive download <fileId>
gog drive download <fileId> --output "./local-file.pdf"Googleドキュメントのエクスポート
# スプレッドシート → CSV
gog drive download <spreadsheetId> --export-format csv
# ドキュメント → PDF
gog drive download <docId> --export-format pdf
# スライド → PPTX
gog drive download <slideId> --export-format pptxアップロード
gog drive upload "./local-file.pdf"
gog drive upload "./file.xlsx" --parent <folderId>コピー
gog drive copy <fileId> "コピー名"
gog drive copy <fileId> "コピー名" --parent <folderId>移動
gog drive move <fileId> --parent <newFolderId>リネーム
gog drive rename <fileId> "新しい名前"削除
gog drive delete <fileId>
gog drive delete <fileId> --force # 確認スキップフォルダ操作
フォルダ作成
gog drive mkdir "新しいフォルダ"
gog drive mkdir "サブフォルダ" --parent <parentFolderId>フォルダ内一覧
gog drive ls --parent <folderId>共有
共有設定
# 閲覧者として共有
gog drive share <fileId> --email "user@example.com" --role reader
# 編集者として共有
gog drive share <fileId> --email "user@example.com" --role writer
# コメント権限
gog drive share <fileId> --email "user@example.com" --role commenter権限一覧
gog drive permissions <fileId>共有解除
gog drive unshare <fileId> <permissionId>共有ロール
| ロール | 説明 |
|---|---|
reader | 閲覧のみ |
commenter | コメント可 |
writer | 編集可 |
owner | オーナー |
URL取得
gog drive url <fileId>
gog drive url <fileId1> <fileId2> <fileId3>コメント
# コメント一覧
gog drive comments list <fileId>
# コメント追加
gog drive comments add <fileId> --content "コメント内容"共有ドライブ
# 共有ドライブ一覧
gog drive drives出力オプション
| オプション | 説明 |
|---|---|
--json | JSON出力 |
--plain | TSV出力 |
--max N | 最大N件 |
典型ワークフロー
ファイル検索→ダウンロード
# 1. 検索
gog drive search "月次レポート" --json
# 2. ダウンロード
gog drive download <fileId> --output "./月次レポート.pdf"フォルダ作成→アップロード→共有
# 1. フォルダ作成
RESULT=$(gog drive mkdir "プロジェクトX資料" --json)
FOLDER_ID=$(echo "$RESULT" | jq -r '.id')
# 2. アップロード
gog drive upload "./proposal.pdf" --parent "$FOLDER_ID"
# 3. 共有
gog drive share "$FOLDER_ID" --email "client@example.com" --role reader
# 4. URL取得
gog drive url "$FOLDER_ID"スプレッドシートをCSVでダウンロード
gog drive download <spreadsheetId> --export-format csv --output "./data.csv"FileId の取得方法
URLから抽出:
https://docs.google.com/spreadsheets/d/<ID>/edit→<ID>部分https://drive.google.com/file/d/<ID>/view→<ID>部分https://docs.google.com/document/d/<ID>/edit→<ID>部分
ゴミ箱に移動
gog drive trash <fileId>ブラウザで開く
gog open <fileId> # ブラウザでファイルを開く
gog open <url> # URLを開くトップレベル download / upload
gog download <fileId> # Drive からダウンロード
gog download <fileId> --output "./file.pdf"
gog upload "./local-file.pdf" # Drive にアップロード
gog upload "./file.xlsx" --parent <folderId>gog drive download / gog drive upload と同等のショートカット。
注意事項
- ゴミ箱:
deleteはゴミ箱に移動（完全削除ではない） - Google形式: スプシ/ドキュメントはダウンロード時にエクスポート形式を指定
- 共有ドライブ:
--shared-driveオプションが必要な場合あり - 大きなファイル: タイムアウトを長めに設定