Google Drive
Upload, download, and manage files and folders in Google Drive via OAuth authentication.
Pre-Flight Check (ALWAYS RUN FIRST)
python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service driveExit codes:
- 0: Ready to use - proceed with user request
- 1: Need to login - run
python3 00-system/skills/google/google-master/scripts/google_auth.py --login - 2: Missing credentials or dependencies - see ../google-master/references/setup-guide.md
Quick Reference
List Files (Root)
python3 00-system/skills/google/google-drive/scripts/drive_operations.py listList Files in Folder
python3 00-system/skills/google/google-drive/scripts/drive_operations.py list --folder <folder_id>Search Files
python3 00-system/skills/google/google-drive/scripts/drive_operations.py search "report"Get File Info
python3 00-system/skills/google/google-drive/scripts/drive_operations.py info <file_id>Download File
python3 00-system/skills/google/google-drive/scripts/drive_operations.py download <file_id> --output ./local_file.pdfDownload Google Doc as PDF
python3 00-system/skills/google/google-drive/scripts/drive_operations.py download <doc_id> --format pdfUpload File
python3 00-system/skills/google/google-drive/scripts/drive_operations.py upload ./local_file.pdf --folder <folder_id>Create Folder
python3 00-system/skills/google/google-drive/scripts/drive_operations.py create-folder "New Folder" --parent <parent_id>Move File
python3 00-system/skills/google/google-drive/scripts/drive_operations.py move <file_id> <destination_folder_id>Copy File
python3 00-system/skills/google/google-drive/scripts/drive_operations.py copy <file_id> --name "Copy of File"Rename File
python3 00-system/skills/google/google-drive/scripts/drive_operations.py rename <file_id> "New Name"Delete File (Trash)
python3 00-system/skills/google/google-drive/scripts/drive_operations.py delete <file_id>Share File
python3 00-system/skills/google/google-drive/scripts/drive_operations.py share <file_id> user@example.com --role writerGet Sharing Info
python3 00-system/skills/google/google-drive/scripts/drive_operations.py sharing <file_id>File/Folder ID
The ID is in the URL:
https://drive.google.com/file/d/[FILE_ID]/view
https://drive.google.com/drive/folders/[FOLDER_ID]Export Formats
For Google Docs files, use --format when downloading:
| File Type | Available Formats |
|---|---|
| Google Docs | pdf, docx, txt, html |
| Google Sheets | pdf, xlsx, csv |
| Google Slides | pdf, pptx |
Available Operations
| Operation | Function | Description |
|---|---|---|
| List | list_files() | List files in a folder |
| Search | search_files() | Search by name |
| Info | get_file_info() | Get file metadata |
| Download | download_file() | Download to local |
| Upload | upload_file() | Upload from local |
| Create Folder | create_folder() | Create new folder |
| Move | move_file() | Move to different folder |
| Copy | copy_file() | Duplicate a file |
| Rename | rename_file() | Change name |
| Delete | delete_file() | Move to trash |
| Share | share_file() | Share with user |
| Sharing | get_sharing_info() | Get permissions |
Sharing Roles
| Role | Permissions |
|---|---|
reader | View only |
commenter | View and comment |
writer | View, comment, and edit |
Error Handling
See ../google-master/references/error-handling.md for common errors and solutions.
Setup
First-time setup: ../google-master/references/setup-guide.md
Quick start:
pip install google-auth google-auth-oauthlib google-api-python-client- Create OAuth credentials in Google Cloud Console (enable Google Drive API, choose "Desktop app")
- Add to
.envfile at Nexus root:GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your-client-secret GOOGLE_PROJECT_ID=your-project-id - Run
python3 00-system/skills/google/google-master/scripts/google_auth.py --login