# 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**

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

**Stap 2: Download GAM7**

macOS:
```bash
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:
```bash
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**

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

**Stap 4: Test**

```bash
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

```bash
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:**
```bash
gam csv users.csv gam create user ~primaryEmail firstname ~firstname lastname ~lastname password ~password changepassword on
```

**Alle extern gedeelde bestanden inventariseren:**
```bash
gam all users print filelist query "visibility='anyoneWithLink'" allfields todrive
```

**Licenties synchroniseren met OU:**
```bash
gam ou /Marketing sync license workspacebusinessstandard
```

**Groep-lidmaatschap pullen:**
```bash
gam group info team@domein.nl
```

**2FA status voor alle gebruikers:**
```bash
gam print users fields name,email,is2svenrolled todrive
```

**Drive-ransomware detectie (bestanden massaal gewijzigd):**
```bash
gam user jan@domein.nl print filelist query "modifiedTime > '2026-04-01T00:00:00'" allfields todrive
```

**Inactive accounts detecteren:**
```bash
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:**
```bash
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:**
```bash
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.

## Veelgestelde vragen

**Moet ik sowieso upgraden van GAMADV-XTD3 naar GAM7?**
Ja, sterk aanbevolen. GAMADV-XTD3 wordt niet meer ontwikkeld. Nieuwe APIs (Chat admin, Meet) komen alleen in GAM7. De oude tool blijft werken, maar raakt achter.

**Is GAM7 gratis?**
Ja. Net als zijn voorgangers is GAM7 open source en gratis te gebruiken. De enige kosten zijn indirect: API-calls tellen mee voor je standaard Workspace API-quota.

**Kan ik GAM7 gebruiken met Google Workspace for Nonprofits?**
Ja, elk Workspace-abonnement werkt.

**Werkt GAM7 met Gemini Enterprise?**
Ja. GAM7 heeft commands voor licentiebeheer van Gemini Enterprise-licenties en voor Gemini-gerelateerde instellingen.

**Welke scripting-taal is GAM7 geschreven in?**
Python. De binaries zijn pre-compiled, dus je hoeft geen Python te installeren om GAM7 te draaien.

**Kan ik GAM7 in een Docker-container draaien?**
Ja, handig voor geautomatiseerde workflows. Community-Dockerfiles zijn beschikbaar; volg de officiele setup-instructies voor de credentials-mount.

**Hoe handel ik een bulk-actie af die per ongeluk fout ging?**
GAM7 heeft geen automatische rollback. Daarom: altijd eerst dry-run via `gam print`, test op een testgebruiker, draai productie-commando's met `| tee output.log` om een logboek te hebben. Voor gewijzigde gebruikersdata werkt Google Vault voor herstel binnen retentieperiode.

**Kan ik GAM7 delen met collega's?**
Alleen via de installatie, nooit via de config (oauth-tokens). Elke beheerder maakt zijn eigen GAM7-setup met zijn eigen credentials. Zo blijft audit-traceability intact.

## 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.