Google Drive CLI

Manage Google Drive using the gdrv command-line tool.

Prerequisites

gdrv --version
export GDRV_CREDENTIALS='path/to/credentials.json'
gdrv auth login

Authentication

• Service account or OAuth2 credentials
• Environment variable: GDRV_CREDENTIALS
• OAuth flow: gdrv auth login

File Operations

Upload

gdrv upload file.txt --folder "Backups"
gdrv upload ./folder --recursive --folder "Archive"

Download

gdrv download FILE_ID --output ./downloads
gdrv download --query "name contains 'Report'" --output ./reports

List & Search

gdrv list --folder "Documents" --limit 100
gdrv search "*.pdf" --folder "Reports"
gdrv list --trashed

Folder Management

gdrv folder create "New Folder" --parent PARENT_ID
gdrv folder list --parent ROOT
gdrv folder delete FOLDER_ID --confirm

Permissions

gdrv share FILE_ID --email user@example.com --role editor
gdrv share FILE_ID --anyone --role viewer
gdrv permissions list FILE_ID
gdrv permissions revoke FILE_ID PERMISSION_ID

Agent Best Practices

1. Use folder names when possible; resolve IDs with gdrv list
2. Recursive uploads for directory backups
3. Query syntax for complex searches
4. Service accounts for automation (no user interaction)