Steeds opnieuw vragen of er iets veranderd is, kost quota en geeft vertraging. Veel Workspace-API's kunnen je in plaats daarvan een seintje sturen zodra er iets gebeurt. Dit heet een push-notificatie of watch-channel. In dit artikel leer je hoe je realtime op wijzigingen reageert zonder te pollen.
Twee modellen voor notificaties
Workspace kent grofweg twee benaderingen, afhankelijk van de API. Kies op basis van welke dienst je nodig hebt:
| Model | Wanneer | Transport |
|---|---|---|
| Klassieke watch-channels | Drive en Calendar | HTTPS-webhook naar jouw doel-URL |
| Workspace Events API | Chat, Meet, Drive en meer | Google Cloud Pub/Sub |
Werk je met Drive of Calendar, dan liggen de klassieke watch-channels het meest voor de hand: ze sturen berichten naar een webhook-URL en je moet ze periodiek vernieuwen. Wil je een uniform model over meerdere diensten, dan biedt de nieuwere Workspace Events API abonnementen via Pub/Sub.
Klassieke watch-channels
Bij Drive en Calendar registreer je een channel met een doel-URL. De API stuurt dan een HTTP-melding bij elke wijziging.
Een watch-channel opzetten
- Zet een publiek bereikbaar HTTPS-endpoint op om meldingen te ontvangen.
- Registreer een channel met de
watch-methode op de resource, met een uniek channel-ID en je doel-URL. - Bewaar het
resourceIden de vervaldatum (expiration) die je terugkrijgt. - Verwerk inkomende meldingen en haal de gewijzigde data op.
- Vernieuw het channel voor de vervaldatum, want het verloopt.
Channels verlopen, vernieuw ze op tijd
Watch-channels verlopen na een door de API bepaalde periode. Een Drive-channel verloopt na maximaal zeven dagen. Er is geen automatische verlenging: je vervangt een channel door opnieuw watch aan te roepen met een nieuw, uniek channel-ID. Plan dat met een geautomatiseerde taak, anders stoppen de meldingen stilletjes. Bewaak ook of je channel nog actief is, zodat je een onderbreking snel opmerkt in plaats van pas als je data achterloopt.
Meldingen verifieren
Een melding komt binnen op je publieke endpoint, dus je moet bewijzen dat hij echt is.
Beveilig je notificatie-endpoint
Een notificatie-endpoint is publiek bereikbaar en dus een doelwit. Gebruik bij registratie een geheim token dat de API in elke melding meestuurt (bij Drive en Calendar in de X-Goog-Channel-Token-header), en verifieer dat token bij ontvangst. Valideer ook het channel-ID. Zonder deze controles kan iedereen valse meldingen sturen en je systeem misleiden.
De Workspace Events API
Voor nieuwere integraties biedt de Workspace Events API een consistenter model. Je maakt een subscription op een resource en de events stromen via Pub/Sub binnen. Per juni 2026 zijn abonnementen op Chat en Meet algemeen beschikbaar, en is Drive via deze API beschikbaar (de Drive-events liepen in 2025 als developer preview).
Een Events API-subscription opzetten
- Zet een Pub/Sub-topic op en geef het juiste Workspace-serviceaccount publiceerrechten op dat topic.
- Maak een subscription aan voor de gewenste resource en event-types.
- Workspace publiceert events naar je topic bij elke relevante wijziging.
- Je verwerker leest de events uit een Pub/Sub-subscription op dat topic.
- Vernieuw de subscription voordat die verloopt.
Verwerk events idempotent
Verwerk events altijd idempotent en haal bij een melding de actuele staat op in plaats van blind op de payload te vertrouwen. Een melding zegt vaak alleen dat er iets veranderde, niet precies wat. Door de resource opnieuw op te halen werk je altijd met de juiste, complete data. Bij Drive doe je dat gericht via een changes-call, bij Calendar via een sync-token.
Veelgestelde vragen
Waarom krijg ik geen meldingen meer?
Bijna altijd is het channel of de subscription verlopen. Controleer de vervaldatum en zet automatische vernieuwing op. Bedenk dat een Drive-channel niet automatisch wordt verlengd, dus je moet zelf op tijd een nieuw channel aanmaken.
Bevat de melding zelf de gewijzigde data?
Vaak alleen een signaal dat iets veranderde. Haal de actuele data daarna gericht op, bijvoorbeeld via een changes- of history-call. Voor Chat- en Drive-events kun je via payload-opties wel meer detail in de event opnemen.
Wat is beter, watch-channels of de Events API?
Voor nieuwe projecten is de Workspace Events API met Pub/Sub meestal de betere keuze door het uniforme, betrouwbare model over meerdere diensten. Klassieke watch-channels blijven relevant voor API's zoals Calendar die nog op dat model leunen.
Hoe vaak moet ik vernieuwen?
Dat hangt af van de API en de vervaltermijn die je terugkrijgt. Voor Drive-watch-channels is dat maximaal zeven dagen. Plan vernieuwing ruim voor de vervaldatum om gaten te voorkomen.
Waarom Pub/Sub in plaats van een directe webhook?
Pub/Sub vangt pieken op, bewaart events als je verwerker even down is, en levert bevestigde aflevering met retries. Dat maakt je integratie betrouwbaarder dan een rechtstreekse HTTP-webhook die meldingen kan missen.
Met push-notificaties bouw je reactieve integraties die binnen seconden op Workspace-wijzigingen reageren, zonder verspillend pollen.