gws-best-practices

Generate a .docx file locally with the python-docx library, then upload it using gws drive files create with mimeType set to application/vnd.google-apps.document. This triggers automatic conversion to Google Docs format and returns a file ID for the document link.

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 that would be lost by re-uploading a converted file.

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.

The Slides API converts \n into a new paragraph marker, creating separate paragraphs or bullet points. The \v vertical tab creates a soft line break within a single paragraph, like pressing Shift+Enter.

No, permanent deletion is strictly prohibited because it is irreversible and risks catastrophic data loss. Always use trash or archive operations instead, and confirm explicitly with the user before any deletion.

The browser environment may not be logged into the correct Google account and will likely fail to access the file. Use gws commands like gws drive export to view and interact with Drive content instead.