gws-best-practices

Generate the document locally with python-docx as a .docx file, then upload it with gws drive files create. Set the JSON mimeType to application/vnd.google-apps.document to trigger automatic conversion to Google Docs format.

Use gws docs documents batchUpdate to edit the document in place. This is the only method that preserves comments, suggestions, and other Google-specific features in existing Docs.

Only Drive, Docs, Sheets, and Slides are available and pre-configured. Services like Gmail, Calendar, Tasks, and Chat are not available and should not be attempted.

In gws slides batchUpdate, \n creates a new paragraph like pressing Enter, while \v inserts a soft line break within the same paragraph like Shift+Enter. Use \n for separate bullet points and \v for multi-line text in one block.

No, the browser environment may not be logged into the correct Google account and will likely fail. Use gws commands such as gws drive export to view or retrieve file content instead.

Permanent deletion is irreversible and can cause catastrophic data loss. Always use trash or archive operations first and confirm explicitly before any destructive action, even if deletion is requested.