Google Workspace CLI : Outil gws ultime
Google Workspace CLI : L'outil en ligne de commande gws ultime
Google a dévoilé un véritable game-changer pour les utilisateurs avancés de Workspace et les développeurs d'IA : gws - un CLI unique qui déverrouille toutes les API Google Workspace sans aucun code boilerplate. Des fichiers Drive à l'automatisation Gmail, des événements Calendar à la manipulation Sheets, cette bête propulsée par Rust gère tout.
🚀 Pourquoi gws change tout
Contrairement aux clients API traditionnels avec des listes de commandes statiques, gws lit le Service de découverte de Google au moment de l'exécution et construit dynamiquement toute sa surface de commandes. Quand Google ajoute de nouveaux points de terminaison API, gws les récupère automatiquement. Fini de fouiller dans les docs REST ou d'écrire des cauchemars curl.
Fonctionnalités clés : - Drive, Gmail, Calendar, Sheets, Chat, Admin - toutes les API Workspace - Sortie JSON structurée parfaite pour les agents IA et les scripts - Plus de 40 compétences d'agents intégrées pour les workflows courants - Auto-pagination, dry-run, introspection de schéma - Binaires multiplateformes via npm (aucun outil Rust requis)
🎯 Démarrage rapide (2 minutes)
# Installation globale
npm install -g @googleworkspace/cli
# Configuration de l'authentification
gws auth setup
gws auth login
# Lister les fichiers Drive récents
gws drive files list --params '{"pageSize": 10}'
# Créer une feuille de calcul
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'
🤖 Conçu pour les agents IA
gws est livré avec plus de 100 compétences d'agents (fichiers SKILL.md) couvrant toutes les API plus des recettes Gmail, de l'automatisation Drive, et plus encore. Associez-le à votre LLM pour une gestion autonome de Workspace :
# Installer toutes les compétences
npx skills add https://github.com/googleworkspace/cli
# Extension CLI Gemini
gemini extensions install https://github.com/googleworkspace/cli
🔐 Workflows d'authentification multiples
- Interactif :
gws auth login(identifiants chiffrés) - Sans tête/CI : Exporter les identifiants d'une session interactive
- Comptes de service : Pointer vers un fichier de clé JSON
- gcloud :
GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token)
💎 Astuces pro
# Diffuser tous les fichiers en NDJSON
gws drive files list --page-all | jq -r '.files[].name'
# Dry-run message Chat
gws chat spaces messages create --dry-run
# Introspection de tout schéma de méthode
gws schema drive.files.list
# Intégration Model Armor pour agents sécurisés
gws gmail users messages get --sanitize "projects/P/locations/L/templates/T"
📦 Options d'installation
# npm (recommandé - inclut les binaires)
npm install -g @googleworkspace/cli
# Cargo
cargo install --git https://github.com/googleworkspace/cli --locked
# Nix
nix run github:googleworkspace/cli
⚠️ Notes importantes
- Activement développé - attendez des changements cassants vers v1.0
- Non officiellement supporté par Google (mais de l'org googleworkspace)
- 17,9k étoiles, 32 contributeurs, sous licence Apache-2.0
gws n'est pas juste un CLI - c'est l'avenir de l'automatisation Google Workspace pour les humains ET les agents IA. Installez-le dès aujourd'hui et dites adieu à la chasse aux docs API pour toujours.