Google Drive
Use gog for Google Drive operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema drive --json
gog --readonly --account user@example.com drive ls --max 20 --json --wrap-untrusted
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
activity |
Query Drive Activity audit events |
audit |
Audit Drive sharing without mutation |
bulk |
Bulk Drive permission operations |
changes |
Track Drive changes for sync and automation |
comments |
Manage comments on files |
copy |
Copy a file |
delete |
Move a file to trash (use --permanent to delete forever) |
download |
Download a file (exports Google Docs formats) |
drives |
List shared drives (Team Drives) |
du |
Summarize Drive folder sizes |
get |
Get file metadata |
inventory |
Export a read-only Drive inventory |
labels |
Read and modify Drive labels |
ls |
List files in a folder (default: root) |
mkdir |
Create a folder |
move |
Move a file to a different folder |
permissions |
List permissions on a file |
raw |
Dump raw Google Drive API response as JSON (Files.Get; lossless; for scripting and LLM consumption) |
rename |
Rename a file or folder |
revisions |
List and inspect file revisions |
search |
Full-text search across Drive |
share |
Share a file or folder |
shortcut |
Manage shortcuts to Drive files and folders |
sync |
Reconcile local files with Drive |
tree |
Print a read-only folder tree |
unshare |
Remove a permission from a file |
upload |
Upload a file |
url |
Print web URLs for files |
Run gog drive <command> --help for flags and gog schema drive <command> --json
for the machine-readable contract. Do not guess command syntax.