gws - Shared Reference

Shared authentication, CLI syntax, and output formatting patterns for gws Google Workspace commands.

- Supports browser-based OAuth login and service account authentication via GOOGLE_APPLICATION_CREDENTIALS

- Global flags enable output format selection (JSON, table, YAML, CSV), dry-run validation, and PII screening via Model Armor

- Method flags cover parameterized queries, request bodies, file uploads, multipart operations, and automatic pagination with configurable delays

- Built-in security guardrails prevent secret leakage and require user confirmation before write/delete operations

- Shell-specific guidance for zsh history expansion and JSON quoting to avoid common command-line parsing errors

gws - Shared Reference

Installation

The gws binary must be on $PATH. See the project README for install options.

Authentication

# Browser-based OAuth (interactive)
gws auth login

# Service Account
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json

Global Flags