| name | google-drive |
| version | 1 |
| description | Manage Google Drive files and folders. Load when user mentions 'google drive', 'drive', 'upload file', 'download file', 'share file', 'create folder', or references cloud file storage operations. |
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 drive
Exit 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 list
List 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.pdf
Download Google Doc as PDF
python3 00-system/skills/google/google-drive/scripts/drive_operations.py download <doc_id> --format pdf
Upload 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 writer
Get 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
.env file 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
