gws-best-practices

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

The gws CLI supports Drive, Docs, Sheets, and Slides only. Services like Gmail, Calendar, Tasks, and Chat are not available and should not be attempted.

In the Slides API, \n creates a new paragraph like pressing Enter, while \v (vertical tab) creates 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 or get commands to view and interact with Drive, Docs, Sheets, and Slides content.

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; re-uploading a converted file would lose them.

Permanent deletion is strictly prohibited by these guidelines. Always use trash or archive operations instead, and confirm explicitly with the user before any destructive action, since permanent deletion is irreversible.