Google Workspace CLI: La herramienta definitiva de línea de comandos gws

Google ha lanzado un cambio de juego para los usuarios avanzados de Workspace y desarrolladores de IA: gws - una sola CLI que desbloquea cada API de Google Workspace sin código boilerplate. Desde archivos de Drive hasta automatización de Gmail, eventos de Calendar hasta manipulación de Sheets, esta bestia impulsada por Rust lo maneja todo.

🚀 Por qué gws lo cambia todo

A diferencia de los clientes de API tradicionales con listas de comandos estáticas, gws lee el Servicio de Descubrimiento de Google en tiempo de ejecución y construye dinámicamente toda su superficie de comandos. Cuando Google agrega nuevos endpoints de API, gws los detecta automáticamente. No más buscando en docs de REST o escribiendo pesadillas de curl.

Características clave: - Drive, Gmail, Calendar, Sheets, Chat, Admin - todas las APIs de Workspace - Salida JSON estructurada perfecta para agentes de IA y scripting - Más de 40 habilidades de agente integradas para flujos de trabajo comunes - Auto-paginación, dry-run, introspección de esquemas - Binarios multiplataforma vía npm (no se necesita toolchain de Rust)

🎯 Inicio rápido (2 minutos)

# Instalar globalmente
npm install -g @googleworkspace/cli

# Configurar autenticación
gws auth setup

gws auth login

# Listar archivos recientes de Drive
gws drive files list --params '{"pageSize": 10}'

# Crear una hoja de cálculo
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'

🤖 Diseñado para agentes de IA

gws viene con más de 100 Habilidades de Agente (archivos SKILL.md) que cubren cada API más recetas de Gmail, automatización de Drive y más. Combínalo con tu LLM para gestión autónoma de Workspace:

# Instalar todas las habilidades
npx skills add https://github.com/googleworkspace/cli

# Extensión CLI de Gemini
gemini extensions install https://github.com/googleworkspace/cli

🔐 Flujos de autenticación múltiples

• Interactivo: gws auth login (credenciales encriptadas)
• Headless/CI: Exportar credenciales de sesión interactiva
• Cuentas de servicio: Apuntar a archivo de clave JSON
• gcloud: GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)

💎 Consejos Pro

# Transmitir todos los archivos como NDJSON
gws drive files list --page-all | jq -r '.files[].name'

# Dry-run de mensaje de Chat
gws chat spaces messages create --dry-run

# Introspeccionar esquema de cualquier método
gws schema drive.files.list

# Integración Model Armor para agentes seguros
gws gmail users messages get --sanitize "projects/P/locations/L/templates/T"

📦 Opciones de instalación

# npm (recomendado - incluye binarios)
npm install -g @googleworkspace/cli

# Cargo
cargo install --git https://github.com/googleworkspace/cli --locked

# Nix
nix run github:googleworkspace/cli

⚠️ Notas importantes

• En desarrollo activo - espera cambios rompientes hacia v1.0
• No soportado oficialmente por Google (pero del org googleworkspace)
• 17.9k estrellas, 32 colaboradores, licenciado bajo Apache-2.0

gws no es solo una CLI - es el futuro de la automatización de Google Workspace para humanos Y agentes de IA. Instálalo hoy y di adiós a la caza de documentación de API para siempre.

⭐ Star en GitHub | 📦 npm