About gdrive
gdrive is a skill for operating Google Drive through the gog CLI. It covers file and folder management, sharing, comments, search, and transfers for users automating Drive tasks.
Key features
- 01Search and list Drive files
- 02Upload, download, and export files
- 03Create and manage folders
- 04Copy, move, rename, and trash files
- 05Manage sharing and permissions
- 06Read and add comments
Use cases
- 01Find and download a monthly report
- 02Export a spreadsheet as CSV
- 03Upload files to a project folder and share them
- 04Review or update file comments
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/gdrivein Claude Code to confirm it loaded.
Details
From the project READMEGoogle 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 '[email protected]' 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 "[email protected]" --role reader
# 編集者として共有
gog drive share <fileId> --email "[email protected]" --role writer
# コメント権限
gog drive share <fileId> --email "[email protected]" --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 "[email protected]" --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オプションが必要な場合あり - 大きなファイル: タイムアウトを長めに設定
Comments
Markdown supported