Google Workspace CLI

De Complete Gids voor Google Workspace CLI (gws)

In de moderne werkomgeving is efficiëntie essentieel. De Google Workspace CLI, afgekort als gws, is een revolutionaire opdrachtregeltool die speciaal is ontwikkeld om de interactie met Google Workspace-diensten te vereenvoudigen. Of u nu een ontwikkelaar bent die workflows wil automatiseren of een systeembeheerder die snel taken wil uitvoeren, de Google Workspace CLI biedt een uniforme interface voor alle Workspace API's.

Wat is Google Workspace CLI?

De Google Workspace CLI (gws) is één centrale CLI voor alle Google Workspace-onderdelen, gebouwd met het oog op zowel menselijke gebruikers als AI-agents. In tegenstelling tot traditionele tools die een statische lijst met commando's bevatten, leest de Google Workspace CLI de Google Discovery Service in real-time uit. Dit betekent dat de tool dynamisch zijn commando-oppervlak opbouwt. Wanneer Google een nieuw API-eindpunt toevoegt, pakt de Google Workspace CLI dit automatisch op zonder dat er een handmatige update van de software nodig is.

De tool ondersteunt Drive, Gmail, Calendar, Sheets, Docs, Chat en meer, allemaal met nul boilerplate en een gestructureerde JSON-output die perfect is voor verdere verwerking.

Kenmerken van Google Workspace CLI

De Google Workspace CLI onderscheidt zich door een reeks geavanceerde functies:

• Dynamische Commando-opbouw: Maakt gebruik van de Discovery Service voor altijd up-to-date API-toegang.
• Mensvriendelijk: Biedt uitgebreide --help opties voor elk middel, --dry-run voor het vooraf bekijken van verzoeken, en automatische paginering.
• AI-Agent Gereed: Elke respons is gestructureerde JSON, wat de integratie met LLM's en AI-agents vergemakkelijkt.
• Ingebouwde Skills: Bevat meer dan 100 Agent Skills en 50 gecureerde recepten voor Gmail, Drive en andere diensten.
• Veilige Authenticatie: Ondersteunt meerdere workflows, waaronder OAuth2, Service Accounts en toegangstokens, met versleutelde opslag van inloggegevens via de OS-keyring.
• Helper Commando's: Naast de standaard API-methoden biedt de Google Workspace CLI handige extra's zoals +send voor Gmail of +agenda voor Calendar.

Hoe te Gebruiken

Het gebruik van de Google Workspace CLI begint bij een eenvoudige installatie en configuratie.

Installatie

U kunt de CLI eenvoudig installeren via npm:

npm install -g @googleworkspace/cli

Alternatieve installatiemethoden omvatten Homebrew op macOS/Linux (brew install googleworkspace-cli) of het bouwen vanuit de broncode via Cargo.

Quick Start en Authenticatie

1. Configuratie: Start met gws auth setup. Dit begeleidt u door de configuratie van uw Google Cloud-project.
2. Inloggen: Gebruik gws auth login voor de initiële OAuth-aanmelding.
3. Commando's Uitvoeren:
   • Lijst bestanden in Drive: gws drive files list --params '{"pageSize": 5}'
   • Maak een Spreadsheet: gws sheets spreadsheets create --json '{"properties": {"title": "Budget"}}'

Geavanceerde Commando's

De Google Workspace CLI ondersteunt ook multipart uploads voor Drive en complexe paginering via de --page-all vlag, waarmee resultaten als NDJSON gestreamd kunnen worden.

Use Case scenario's

De veelzijdigheid van de Google Workspace CLI maakt het geschikt voor diverse scenario's:

1. Systeemautomatisering

Beheerders kunnen scripts schrijven die automatisch rapporten genereren in Google Sheets of dagelijkse back-ups van Drive-bestanden beheren zonder handmatige interventie in de browser.

2. AI-Agent Integratie

Door de Google Workspace CLI te koppelen aan de Gemini CLI-extensie, kan een AI-agent direct acties uitvoeren zoals het samenvatten van ongelezen e-mails of het plannen van vergaderingen op basis van natuurlijke taal.

3. Headless CI/CD Workflows

In een CI/CD-omgeving kunnen credentials geëxporteerd worden (gws auth export) en via omgevingsvariabelen worden gebruikt om geautomatiseerde meldingen naar Google Chat te sturen of documentatie bij te werken.

FAQ (Veelgestelde Vragen)

Is de Google Workspace CLI een officieel Google-product? Nee, dit is geen officieel ondersteund product van Google, maar een open-source project onder de Apache-2.0 licentie.

Wat moet ik doen als ik een "Access blocked" foutmelding krijg tijdens het inloggen? Dit gebeurt vaak wanneer uw OAuth-app in de 'testing' modus staat. U moet uw eigen e-mailadres toevoegen als 'Test user' in de Google Cloud Console onder het OAuth-toestemmingsscherm.

Ondersteunt gws Service Accounts? Ja, u kunt een Service Account gebruiken door het pad naar uw JSON-sleutelbestand in te stellen via de variabele GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE.

Hoe ga ik om met te veel OAuth-scopes? Ongeverifieerde apps zijn beperkt tot ongeveer 25 scopes. Gebruik de -s of --scopes vlag bij het inloggen om alleen de benodigde diensten te selecteren, bijvoorbeeld: gws auth login -s drive,gmail.

Wat zijn de systeemvereisten? De CLI vereist Node.js 18 of hoger voor installatie via npm, of een functionerende Rust-toolchain als u vanuit de broncode bouwt. Een Google Cloud-project met geactiveerde API's is noodzakelijk voor de werking.