Google Workspace CLI
Google Workspace (googleworkspace GitHub organization) · Programmation
Google Workspace CLI, que presque tout le monde appelle gws, est un outil en ligne de commande gratuit et open source qui place Drive, Gmail, Calendar, Sheets, Docs, Chat et Admin derrière une interface unique pour que vous ne touchiez plus jamais à l'interface web. Au lieu d'écrire à la main des appels curl contre la documentation REST, vous lancez une commande et récupérez du JSON structuré. Il a été conçu pour deux publics à la fois : les développeurs qui veulent automatiser Workspace rapidement, et les agents d'IA qui ont besoin d'une sortie lisible par machine et de compétences prêtes à l'emploi. Ce partage explique beaucoup de choses.
À propos de Google Workspace CLI
Qu'est-ce que Google Workspace CLI
Google Workspace CLI est un outil écrit en Rust, issu de l'organisation GitHub googleworkspace, qui enveloppe toutes les API Google Workspace dans un seul binaire. L'astuce, c'est qu'il ne livre pas une liste figée de commandes. Il lit le Discovery Service de Google à l'exécution et construit sa surface de commandes à la volée, si bien que lorsque Google ajoute un point de terminaison d'API, gws le récupère sans mise à jour. La sortie est du JSON structuré par défaut, ce qui le rend aussi utile à un script ou à un LLM qu'à une personne assise devant un terminal.
Le projet s'adresse à ceux qui passent leurs journées dans Workspace et veulent arrêter de cliquer dans l'interface web, ainsi qu'à la foule croissante de développeurs qui branchent des assistants d'IA sur les outils métiers du quotidien. Vous vous authentifiez une fois avec OAuth, puis vous listez des fichiers, créez des feuilles de calcul, envoyez des messages Chat ou récupérez des événements d'agenda depuis un seul shell. Il embarque aussi une quarantaine de compétences d'agents d'IA, ce qui permet à un assistant de gérer les tâches Workspace sans outillage sur mesure. Aucun code de liaison nécessaire.
Une mise en garde importante : ce n'est pas un produit Google officiellement pris en charge. Le développement est actif et les mainteneurs préviennent qu'il faut s'attendre à des ruptures de compatibilité d'ici la version 1.0. Faut-il s'en soucier ? Oui, si vos scripts ont besoin de stabilité à long terme. La licence est Apache-2.0, et il vous faut votre propre projet Google Cloud pour les identifiants OAuth. Si vous cherchez un outil abouti et garanti stable, ce n'est pas celui-ci. Si vous en voulez un qui avance vite et atteint toutes les API Workspace, difficile de faire mieux. À vous de choisir le compromis.
Premiers pas
- Installez Node.js 18 ou plus récent, ou récupérez un binaire précompilé pour votre système depuis la page GitHub Releases.
- Installez gws avec
npm install -g @googleworkspace/cli, ou passez par Homebrew sur macOS. - Lancez
gws auth setuppour parcourir la configuration du projet Google Cloud et des identifiants OAuth. - Connectez-vous avec
gws auth loginà l'aide d'un compte Google ayant accès à Workspace. - Essayez une vraie commande, comme lister vos dix fichiers Drive les plus récents, et examinez la réponse JSON.
Informations sur le produit
Aperçu des tarifs, des plateformes compatibles et des performances de Google Workspace CLI.
Idéal pour
Les utilisateurs, tâches et cas d'usage où cet outil convient le mieux.
Utilisateurs
- Développeurs qui scriptent des tâches Workspace
- Créateurs d'agents d'IA
- Administrateurs système et équipes IT
Tâches
- Automatiser les opérations sur les fichiers Drive
- Générer des rapports dans Sheets
- Envoyer des messages Chat ou Gmail depuis des scripts
Cas d'usage
- Intégrer Workspace à un pipeline CI/CD
- Construire un assistant personnel qui réserve des réunions ou classe des documents sur demande.
- Administration en masse de l'espace de travail sur de nombreux comptes et lecteurs partagés.
Fonctionnalités clés
Une surface de commandes construite en direct depuis le Discovery Service
La CLI ne code pas ses commandes en dur. Elle lit le Discovery Service de Google à l'exécution, si bien que chaque point de terminaison et méthode de l'API Workspace devient disponible comme commande automatiquement. Quand Google publie un nouveau point de terminaison, vous l'avez sans attendre une version de gws. Voilà ce qui garde l'outil à jour d'une manière que les wrappers statiques ne peuvent pas égaler. C'est aussi simple que ça.
Une sortie JSON structurée pour les agents
Chaque réponse revient en JSON structuré. Pour les humains, cela veut dire une sortie prévisible et analysable que vous pouvez diriger vers jq ou un script. Pour les agents d'IA, cela veut dire qu'un LLM peut lire les données Workspace et agir dessus sans aucun code de liaison. C'est la raison centrale pour laquelle l'outil se vend autant aux développeurs d'agents qu'aux particuliers. La sortie reste propre.
Des compétences d'agents d'IA incluses
Une quarantaine de compétences d'agent accompagnent le projet et couvrent les flux de travail Workspace courants. Au lieu d'écrire des définitions d'outils à partir de zéro, vous pouvez les déposer dans un agent et le laisser gérer les tâches Drive, Gmail ou Calendar. Cela raccourcit le chemin entre « j'ai un LLM » et « mon LLM peut gérer mon Workspace ». Un fameux raccourci.
Aide intégrée, simulations et pagination automatique
Chaque ressource prend en charge --help, pour explorer les commandes sans quitter le terminal. L'option --dry-run prévisualise la requête avant son envoi, ce qui est pratique lorsqu'on découvre un point de terminaison inconnu. La pagination automatique gère les grands ensembles de résultats, vous n'avez donc pas à écrire de boucles pour parcourir des centaines de fichiers Drive ou messages Gmail lot par lot.
Une interface unique pour tous les services Workspace
Drive, Gmail, Calendar, Sheets, Docs, Chat et Admin se trouvent derrière la même structure de commandes. Vous apprenez le schéma une fois et l'appliquez partout, ce qui réduit le changement de contexte lié à la jonglerie entre SDK séparés. Une seule connexion couvre toute la surface. C'est tout l'intérêt.
Des options d'installation multiplateforme
Vous pouvez installer gws via npm, Homebrew, Cargo ou un flake Nix, ou simplement télécharger un binaire précompilé pour votre système. Cette souplesse lui permet de s'intégrer à la plupart des environnements de développement, sur un portable Mac, un serveur Linux ou une machine Windows.
Avantages et inconvénients
Avantages
- Gratuit et open source sous Apache-2.0, sans niveaux payants à gérer.
- Couvre toutes les API Google Workspace via une interface cohérente.
- L'intégration live au Discovery Service garde l'ensemble des commandes à jour, ce qui facilite la maintenance de l'automatisation Google Workspace.
- La sortie JSON et les compétences d'agent incluses le rendent vraiment utile pour les flux de travail d'agents d'IA.
- De multiples voies d'installation (npm, Homebrew, Cargo, Nix, binaires précompilés) conviennent à presque toutes les configurations.
Inconvénients
- Ce n'est pas un produit Google officiellement pris en charge, donc aucune promesse formelle de support Google.
- Des ruptures de compatibilité sont attendues avant la version 1.0, ce qui signifie que les scripts peuvent nécessiter des mises à jour après les versions.
- La configuration exige votre propre projet Google Cloud et une configuration OAuth, un vrai obstacle pour les non-développeurs.
Questions fréquentes
Oui. Il est open source sous licence Apache-2.0 et ne coûte rien. Il vous faut un compte Google et, pour OAuth, un projet Google Cloud, mais ni l'un ni l'autre n'entraîne de frais pour un usage personnel ou de développeur classique.
Contenus associés
Découvrez des outils, des compétences et des articles liés à Google Workspace CLI.
Alternatives à Google Workspace CLI
Codeflying
Kuafu Technology (Codeflying) · Programmation · Marketing · ChatbotCodeflying est un créateur d'apps par IA qui transforme une description en langage naturel en un site web, une app mobile ou une mini app fonctionnels. Il fonctionne comme un créateur d'apps sans code : vous tapez ce que vous voulez et une série d'agents IA prennent en charge les besoins, l'architecture, les écrans front-end, la logique back-end et le déploiement. L'objectif est simple : créer une app à partir d'un prompt, même sans aucune base en programmation. Des outils marketing et un agent de chat pour la clientèle sont aussi inclus, donc le résultat est plus qu'un prototype oublié sur un disque dur.
Runware
Runware, Inc. · Image · Vidéo · ProgrammationRunware est une plateforme d'inférence d'IA générative qui donne aux développeurs une seule API pour les modèles d'image, de vidéo, d'audio, de 3D et de langage. Au lieu de s'inscrire chez une dizaine de fournisseurs, vous appelez un unique endpoint, vous changez de modèle avec une ligne de code et vous payez seulement les requêtes que vous envoyez. Aucun serveur à gérer. L'outil vise les équipes qui veulent livrer des fonctions d'IA vite, sans monter ni surveiller leur propre infrastructure GPU.
Aider
Aider AI LLC · ProgrammationAider est un outil de programmation en binôme avec IA open source qui vit dans votre terminal. Vous le pointez vers un dépôt git local, vous décrivez ce que vous voulez en langage naturel et il modifie les fichiers, écrit les diffs et enregistre les modifications à votre place. Il se connecte à Claude, GPT, DeepSeek et Gemini via vos propres clés d'API, et il fait aussi tourner des modèles locaux par Ollama ou n'importe quel point de terminaison compatible avec OpenAI. Les développeurs qui travaillent déjà en ligne de commande l'adoptent vite. Il ne gêne pas. Tout son attrait est là.