abdullahbeam 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
.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