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