GAM7: Google Workspace beheren via command line in 2026

GAM7 is de officiele, unified versie van Google Apps Manager. Het vervangt zowel standaard GAM als GAMADV-XTD3: de twee projecten zijn samengevoegd door maintainers Ross Scroggs en Jay Lee tot één volwassen command-line tool voor Workspace-beheerders. Als jij nog GAMADV-XTD3 draait, is de upgrade naar GAM7 de belangrijkste beheer-actie voor dit jaar. Dit artikel beschrijft waarom, hoe je upgrade en welke nieuwe features GAM7 biedt.

Wat is er veranderd?

Tot 2025 waren er twee gescheiden GAM-projecten:

• Standard GAM (door Jay Lee): focus op veelgebruikte admin-taken
• GAMADV-XTD3 (door Ross Scroggs): geavanceerde rapportages en reporting, grote CSV-output

In 2026 zijn beide samengevoegd tot GAM7, een enkele tool die alle functionaliteit van beide voorgangers biedt. GAMADV-XTD3 is niet verder ontwikkeld; GAM7 is de toekomst.

Belangrijkste verbeteringen van GAM7:

• Snellere startup, vooral op macOS (digital signing)
• Signed binaries op macOS en Windows
• Nieuwe API-support: Google Chat API admin-acties, Google Meet API
• Uniforme documentatie op één GitHub-repo
• Dezelfde gam.cfg als GAMADV-XTD3, dus config-migratie is triviaal

Upgrade van GAMADV-XTD3 naar GAM7

De overstap is eenvoudig omdat GAM7 dezelfde codebasis gebruikt als GAMADV-XTD3. De officiele upgrade-guide op GitHub beschrijft vier stappen:

Stap 1: Back-up je bestaande config

cp -r ~/.gamadvxtd3 ~/.gamadvxtd3.backup

Stap 2: Download GAM7

macOS:

curl -O https://github.com/GAM-team/GAM/releases/latest/download/gam-macos.tar.xz
tar -xf gam-macos.tar.xz

Windows: download de .exe-installer van de GAM7-releases pagina op GitHub.

Linux:

curl -O https://github.com/GAM-team/GAM/releases/latest/download/gam-linux.tar.xz
tar -xf gam-linux.tar.xz

Stap 3: Kopieer je config

cp ~/.gamadvxtd3/gam.cfg ~/.gam7/
cp ~/.gamadvxtd3/oauth2.txt ~/.gam7/
cp ~/.gamadvxtd3/oauth2service.json ~/.gam7/
cp ~/.gamadvxtd3/client_secrets.json ~/.gam7/

Stap 4: Test

gam version
gam info domain

Alle commands uit je oude scripts werken identiek in GAM7.

Installatie vanaf nul (zonder eerdere GAM)

Voor organisaties die nog nooit GAM hebben gebruikt, vereist GAM7 drie dingen:

1. API-project in Google Cloud Console dat GAM identificeert en API-quota bijhoudt
2. Authorisatie als Workspace Administrator voor admin-acties
3. Service account voor per-gebruiker acties zoals Drive, Calendar, Gmail settings

gam create project
gam oauth create
gam user admin@domein.nl check serviceaccount

Elke stap geeft instructies om acties uit te voeren in Google Cloud Console en Admin Console. Reken op 30-45 minuten voor een eerste setup.

Krachtige GAM7-commando's voor dagelijks beheer

Bulk-gebruikers aanmaken vanuit CSV:

gam csv users.csv gam create user ~primaryEmail firstname ~firstname lastname ~lastname password ~password changepassword on

Alle extern gedeelde bestanden inventariseren:

gam all users print filelist query "visibility='anyoneWithLink'" allfields todrive

Licenties synchroniseren met OU:

gam ou /Marketing sync license workspacebusinessstandard

Groep-lidmaatschap pullen:

gam group info team@domein.nl

2FA status voor alle gebruikers:

gam print users fields name,email,is2svenrolled todrive

Drive-ransomware detectie (bestanden massaal gewijzigd):

gam user jan@domein.nl print filelist query "modifiedTime > '2026-04-01T00:00:00'" allfields todrive

Inactive accounts detecteren:

gam report users parameters accounts:last_login_time start 2026-01-01 todrive

Nieuwe API-ondersteuning in GAM7

GAM7 voegde in 2026 onder andere deze APIs toe:

Google Chat API admin-acties:

gam print chatspaces
gam delete chatspace spaces/AAAA...
gam info chatspace spaces/AAAA... members

Handig voor compliance-teams die spaces willen auditen of archiveren.

Google Meet API:

gam print meetrecordings
gam user jan@domein.nl info meetrecording CONFERENCES/xyz

Voor audit en retention van vergaderopnames.

Beveiliging en best practices

GAM7 is krachtig, dat maakt het ook een beveiligingsrisico als de credentials in verkeerde handen vallen:

• Draai GAM7 vanaf een beheerd werkstation, niet vanaf een persoonlijke laptop
• Versleutel de oauth2.txt en oauth2service.json, bv. met filevault op macOS of BitLocker op Windows
• Gebruik een service-account met minimale scopes in plaats van full admin-rechten
• Audit GAM-activiteit via Admin Console > Rapporten > Audit > Token
• Automatiseer via GitHub Actions of Cloud Functions, niet via een persoonlijke cronjob

Tip: Voor bulk-operaties op productie altijd eerst gam print draaien om te verifieren welke accounts betrokken zijn, daarna pas gam update of gam delete. Een typefout in een OU-path kan honderden gebruikers beinvloeden.

Conclusie

GAM7 is in 2026 het standaard gereedschap voor serieuze Workspace-beheerders. Als jij nog op GAMADV-XTD3 zit, plan de upgrade deze maand: de procedure duurt een uur en je krijgt nieuwe API-support, snellere startup en actieve ontwikkeling. Total Workspace helpt Nederlandse organisaties bij de migratie naar GAM7, bij het opstellen van automation-scripts en bij OAuth-beveiliging van admin-tooling.