Google Docs

Read, write, create, and manage Google Docs via OAuth authentication.

Pre-Flight Check (ALWAYS RUN FIRST)

python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service docs

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

Read Document

python3 00-system/skills/google/google-docs/scripts/docs_operations.py read <document_id>

Create Document

python3 00-system/skills/google/google-docs/scripts/docs_operations.py create "My Document" --content "Initial content here"

Insert Text

python3 00-system/skills/google/google-docs/scripts/docs_operations.py insert <document_id> "Text to insert" --index 1

Append Text

python3 00-system/skills/google/google-docs/scripts/docs_operations.py append <document_id> "Text to append at end"

Find and Replace

python3 00-system/skills/google/google-docs/scripts/docs_operations.py replace <document_id> "old text" "new text"

Export Document

python3 00-system/skills/google/google-docs/scripts/docs_operations.py export <document_id> --format pdf --output ./report.pdf

List Documents

python3 00-system/skills/google/google-docs/scripts/docs_operations.py list --query "report"

Copy Document

python3 00-system/skills/google/google-docs/scripts/docs_operations.py copy <document_id> "Copy of My Document"

Rename Document

python3 00-system/skills/google/google-docs/scripts/docs_operations.py rename <document_id> "New Title"

Document ID

The document ID is in the URL:

https://docs.google.com/document/d/[DOCUMENT_ID]/edit

Common Workflows

Generate Report -> Save to Google Docs

from docs_operations import create_document, append_text

doc = create_document("Weekly Report - Jan 2024") append_text(doc['document_id'], "Key findings from this week...") print(f"Report created: {doc['url']}")

Create Document from Template

from docs_operations import copy_document, replace_all_text

new_doc = copy_document(template_id, "Invoice #1234") replace_all_text(new_doc['document_id'], "{{CLIENT}}", "Acme Corp") replace_all_text(new_doc['document_id'], "{{AMOUNT}}", "$5,000")

Available Operations

Operation Function Description

Read read_document()

Get document content

Info get_document_info()

Get title, ID, URL

Create create_document()

Create new document

Copy copy_document()

Duplicate document

Rename rename_document()

Change title

Insert insert_text()

Insert at position

Append append_text()

Add to end

Replace replace_all_text()

Find and replace

Export export_document()

Export to text/HTML/PDF/DOCX

List list_documents()

List accessible docs

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 Docs API & 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