Google Workspace CLI favicon

Google Workspace CLI

Google Workspace CLI (gws) : L'outil de ligne de commande universel pour Drive, Gmail et Calendar

Introduction:

Google Workspace CLI, également connu sous le nom de gws, est une interface de ligne de commande (CLI) dynamique et puissante conçue pour gérer l'intégralité de l'écosystème Google Workspace. Contrairement aux outils statiques, gws interroge en temps réel le service de découverte de Google pour générer ses commandes, garantissant une compatibilité immédiate avec toutes les mises à jour d'API. Que ce soit pour manipuler Google Drive, envoyer des emails via Gmail, gérer des agendas ou automatiser des feuilles de calcul Sheets, cet outil offre une structure JSON native idéale pour les développeurs et les agents d'IA. Il simplifie l'authentification OAuth2, gère la pagination automatique et inclut plus de 100 compétences d'agent (Agent Skills) pour des flux de travail complexes sans code superflu.

Ajouté:

2026-03-17

Visiteurs mensuels:

534773.1K

Google Workspace CLI - AI Tool Screenshot and Interface Preview

Google Workspace CLI Informations sur le produit

Optimisez votre productivité avec Google Workspace CLI (gws)

Le Google Workspace CLI, souvent appelé gws, est l'outil de ligne de commande ultime conçu pour les humains et les agents d'IA. Il permet d'interagir avec Drive, Gmail, Calendar, Sheets, Docs et toutes les API de l'écosystème Workspace sans aucune configuration fastidieuse (zero boilerplate).

Qu'est-ce que Google Workspace CLI (gws) ?

Google Workspace CLI est une interface unique permettant de piloter l'ensemble des services Google Workspace. Sa particularité réside dans son fonctionnement dynamique : il ne possède pas de liste de commandes statique. Au lieu de cela, le Google Workspace CLI lit le Discovery Service de Google au moment de l'exécution pour construire sa surface de commande.

Dès que Google ajoute un nouveau point de terminaison ou une méthode API, le Google Workspace CLI le détecte automatiquement. C'est un outil indispensable pour éviter d'écrire des appels curl complexes contre des documentations REST massives.

Note : Ce projet est en cours de développement actif (v1.0 à venir) et n'est pas un produit officiellement supporté par Google.

Caractéristiques principales du Google Workspace CLI

Le Google Workspace CLI se distingue par des fonctionnalités avancées qui simplifient la gestion administrative et technique de vos outils collaboratifs :

  • Génération dynamique de commandes : Utilise l'API Discovery pour rester toujours à jour.
  • Sortie JSON structurée : Idéal pour le parsing et l'intégration dans des scripts ou des agents LLM.
  • Pagination automatique : Gérez de gros volumes de données sans effort avec le flag --page-all.
  • Compétences d'Agent (Agent Skills) : Plus de 100 compétences incluses pour Gmail, Drive, Docs et plus encore.
  • Authentification flexible : Supporte OAuth2, les comptes de service et les jetons d'accès directs.
  • Sécurité renforcée : Les identifiants sont chiffrés au repos (AES-256-GCM) via le trousseau de clés du système d'exploitation.
  • Commandes d'aide intégrées : Accédez à --help pour chaque ressource et méthode.

Cas d'utilisation (Use Case)

Pour les développeurs

Le Google Workspace CLI permet de tester rapidement des appels API sans coder de client spécifique. Par exemple, pour lister les fichiers Drive ou créer une feuille de calcul Sheets en quelques secondes.

Pour les agents d'IA et LLM

Grâce à l'extension Gemini et aux sorties JSON, un agent d'IA peut utiliser le Google Workspace CLI pour gérer votre boîte mail, planifier des réunions ou extraire des données de documents de manière autonome.

Automatisation CI/CD

Utilisez le Google Workspace CLI dans vos pipelines de déploiement pour envoyer des notifications via Google Chat ou mettre à jour des scripts Apps Script avec la commande gws script +push.

Comment utiliser Google Workspace CLI

Installation

L'installation du Google Workspace CLI est simple via npm :

npm install -g @googleworkspace/cli

Il est également possible de l'installer via Homebrew sur macOS/Linux : brew install googleworkspace-cli ou via Cargo : cargo install --git https://github.com/googleworkspace/cli --locked.

Configuration initiale

  1. Configuration du projet : Lancez gws auth setup pour configurer votre projet Google Cloud.
  2. Connexion : Utilisez gws auth login pour vous authentifier via OAuth.

Exemples de commandes

  • Lister 10 fichiers Drive : gws drive files list --params '{"pageSize": 10}'
  • Envoyer un message Chat : gws chat spaces messages create --params '{"parent": "spaces/xyz"}' --json '{"text": "Déploiement terminé"}'
  • Afficher l'agenda du jour : gws calendar +agenda

FAQ (Foire aux questions)

Q : Pourquoi mon accès est-il bloqué lors de la connexion ? R : Si votre application OAuth est en mode "Test", vous devez impérativement ajouter votre adresse email dans la section "Test users" de la console Google Cloud.

Q : Le CLI gère-t-il les limites de portage (scopes) ? R : Oui. Si vous avez trop de scopes pour une application non vérifiée, utilisez le flag -s pour limiter les services : gws auth login -s drive,gmail.

Q : Comment utiliser gws dans un environnement sans navigateur (Headless) ? R : Vous pouvez exporter vos identifiants avec gws auth export --unmasked sur une machine locale, puis définir la variable d'environnement GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE sur votre serveur distant.

Q : Qu'est-ce que les commandes avec un préfixe "+" ? R : Ce sont des commandes d'aide (helpers) conçues pour simplifier des tâches courantes, comme +send pour Gmail ou +upload pour Drive, qui ne font pas partie de l'API brute.

Loading related products...