Google Workspace is veel meer dan een verzameling apps. Onder de motorkap zit een uitgebreide laag van REST-API's waarmee je vrijwel alles kunt automatiseren wat je normaal handmatig in de admin-console of in een app doet. Of je nu gebruikers wilt aanmaken vanuit je HR-systeem, e-mails wilt verwerken of rapportages wilt bouwen, er is bijna altijd een API voor.
In dit overzicht loop je langs de belangrijkste API-families, zodat je weet welke je nodig hebt voordat je code gaat schrijven.
De Admin SDK API's
De Admin SDK is de verzameling API's die je gebruikt om je Workspace-organisatie te beheren. Dit zijn de zwaargewichten voor IT-beheer.
- Directory API: gebruikers, groepen, organisatie-eenheden (OU's), apparaten en rollen beheren. Dit is je startpunt voor provisioning.
- Reports API: audit-logs en gebruiksstatistieken ophalen. Wie logde wanneer in, hoeveel opslag gebruikt iemand, welke apps worden gebruikt.
- Reseller API: alleen relevant als je partner bent en abonnementen beheert voor klanten.
- Groups Settings API: instellingen van groepen, zoals wie mag posten en wie de ledenlijst ziet.
De Admin SDK vereist bijna altijd een beheerdersaccount of een service account met domain-wide delegation. Een gewone gebruiker kan deze endpoints niet aanroepen.
De productiviteits-API's
Dit zijn de API's rond de apps die je gebruikers dagelijks gebruiken. Ze werken meestal op gebruikersniveau via OAuth.
- Gmail API: berichten lezen, sturen, labels beheren, filters maken en push-notificaties instellen.
- Calendar API: agenda's en afspraken beheren, vrij/bezet opvragen en uitnodigingen sturen.
- Drive API: bestanden uploaden, delen, doorzoeken, permissies beheren en wijzigingen volgen.
- Sheets API: spreadsheets lezen en schrijven, formules zetten en opmaak toepassen.
- Docs API: documenten programmatisch opbouwen en bewerken.
- Slides API: presentaties genereren, ideaal voor datagedreven rapportages.
- Chat API: chatbots bouwen en berichten posten in spaces.
- Meet API: vergaderingen aanmaken en gegevens over deelnemers, opnames en transcripten van afgelopen vergaderingen ophalen.
- Forms API: formulieren maken en antwoorden uitlezen.
- Keep API: notities en lijsten lezen en beheren, handig voor archivering en eDiscovery.
- Apps Script API: scripts en projecten programmatisch beheren en uitvoeren.
- Classroom API: cursussen, deelnemers en opdrachten beheren in het onderwijs.
De governance- en security-API's
Voor compliance, juridische zaken en beveiliging heeft Workspace eigen API's.
- Vault API: e-discovery, legal holds, exports en zoekopdrachten over berichten en bestanden.
- Alert Center API: beveiligingswaarschuwingen ophalen en afhandelen.
- Cloud Identity API: groepen en apparaten op identity-niveau, vaak overlappend met Directory.
Begin altijd klein
Activeer alleen de API's die je echt nodig hebt en vraag alleen de scopes aan die je daadwerkelijk gebruikt. Dat houdt je OAuth-consentscherm overzichtelijk en je beveiligingsrisico laag.
Hoe je begint
Elke Workspace-API draait op de infrastructuur van Google Cloud. Je hebt dus altijd een Google Cloud-project nodig waarin je de API activeert en credentials aanmaakt.
Zo zet je een Workspace-API op
- Maak een project aan in de Google Cloud Console.
- Activeer de gewenste API's via de API-bibliotheek.
- Kies je authenticatiemethode: OAuth 2.0 voor gebruikersdata, of een service account voor server-naar-server.
- Maak credentials aan en bewaar ze veilig (nooit in je codebase of git-historie).
- Installeer de client-bibliotheek voor je taal (Node.js, Python, Java, Go).
- Doe een eerste testcall om te bevestigen dat alles werkt.
Quota en limieten
Elke API heeft quota, meestal uitgedrukt in queries per minuut per gebruiker en per project. Voor grote integraties moet je rekening houden met deze limieten en exponential backoff inbouwen. De meeste API's geven een 429-status terug als je te snel gaat.
Onderschat de quota niet bij bulk-operaties. Als je duizenden gebruikers in een keer aanmaakt via de Directory API, loop je snel tegen limieten aan. Plan batching en backoff in vanaf het begin.
Welke API kies je wanneer
Een snelle wegwijzer per taak:
| Wat wil je doen | Gebruik deze API |
|---|---|
| Gebruikers en groepen beheren vanuit een extern systeem | Directory API |
| Audit-logs of gebruiksrapporten ophalen | Reports API |
| E-mail automatiseren | Gmail API |
| Data in spreadsheets schrijven | Sheets API |
| Een chatbot bouwen | Chat API |
| Vergaderdata of opnames ophalen | Meet API |
| Juridische holds of exports maken | Vault API |
Nieuw in 2026: MCP en AI-agents
Google rolt Model Context Protocol (MCP)-servers uit voor Workspace-diensten, te beginnen met onder meer Calendar (in developer preview). Daarmee kunnen AI-agents op een gecontroleerde manier je agenda lezen en acties uitvoeren, zoals afspraken aanmaken of wijzigen. Voor nieuwe automatiseringsprojecten is het de moeite waard om te checken of er al een MCP-server bestaat voor de dienst die je nodig hebt, voordat je zelf een integratie tegen de REST-API bouwt.
MCP-ondersteuning is in juni 2026 nog volop in ontwikkeling en deels in preview. Controleer de actuele beschikbaarheid en scopes in de officiële Google Workspace-documentatie voordat je erop bouwt voor productie.
Veelgestelde vragen
Heb ik voor elke API een apart Cloud-project nodig?
Nee, je kunt meerdere API's binnen een project activeren. Het is wel verstandig om productie en test te scheiden in aparte projecten, zodat quota en credentials niet door elkaar lopen.
Wat is het verschil tussen OAuth en een service account?
OAuth gebruik je om namens een ingelogde gebruiker te handelen, met diens toestemming. Een service account is een niet-menselijk account voor server-naar-server, ideaal voor achtergrondprocessen. Met domain-wide delegation kan een service account namens gebruikers in je domein handelen.
Zijn alle API's gratis?
Het gebruik van de API's zelf is doorgaans gratis binnen de quota, maar je hebt wel een Workspace-licentie nodig. Sommige functies, zoals Vault, vereisen een hoger abonnement.
Kan ik de API's ook zonder code testen?
Ja, gebruik de API Explorer in de documentatie of een tool als Postman om calls te doen zonder een regel code te schrijven. Handig om scopes en responses te verkennen voordat je gaat bouwen.
Welke API gebruik ik om opnames of transcripten van vergaderingen op te halen?
De Meet REST API. Daarmee haal je conference records op met deelnemers, opnames en transcripten van afgelopen vergaderingen, mits je eigenaar of deelnemer was van de meeting space.
Hoe ga ik om met rate limiting?
Bouw exponential backoff in en respecteer de 429-respons. Gebruik batch-endpoints waar die bestaan en spreid bulk-operaties over de tijd in plaats van alles in een keer te versturen.
Met dit overzicht heb je de landkaart in handen. In de vervolgartikelen duiken we per API de diepte in.