Google Agenda

Overzicht

Google Agenda stelt je in staat je planning te organiseren en evenementen te delen met collega’s. Via Langdock’s integratie kun je Google Agenda rechtstreeks vanuit je gesprekken openen en beheren.

Authenticatie: OAuth Categorie: Google Workspace Beschikbaarheid: Alle workspace-abonnementen

Beschikbare acties

Evenement toevoegen

googlecalendar.addEvent

Maakt een nieuw evenement aan in een specifieke agenda Vereist bevestiging: Ja Parameters:

  • sendUpdates (TEKST, Optioneel): Of er meldingen moeten worden verzonden (‘all’, ‘externalOnly’, ‘none’)

  • startTijd (TEKST, Vereist): Starttijd in RFC3339-formaat (bijv. ‘2025-03-15T09:00:00+01:00’)

  • beschrijving (TEKST, Optioneel): Beschrijving van het evenement (optioneel)

  • attendees (TEKST, Optioneel): Lijst met e-mailadressen van deelnemers (optioneel)

  • recurrence (TEKST, Optioneel): Lijst van RRULE-, EXRULE-, RDATE- en EXDATE-regels voor een terugkerend evenement, zoals gespecificeerd in RFC5545. Let op: DTSTART- en DTEND-regels zijn niet toegestaan. De scheiding tussen regels is een spatie.

  • eindTijd (TEKST, Vereist): Eindtijd in RFC3339-formaat (bijv. ‘2025-03-15T10:00:00+01:00’)

  • calendarId (TEKST, Vereist): De id van de agenda (bijv. ‘primary’ voor de hoofdagenda)

  • location (TEKST, Optioneel): Locatie van het evenement (optioneel)

  • timeZone (TEKST, Vereist): BELANGRIJK: Als je de tijdzone van de gebruiker niet weet, vraag het dan aan hem. RAADPLEEG DE TIJDZONE NIET (Voorbeeldformaat: ‘America/New_York’)

  • titel (TEKST, Vereist): Titel van het evenement

  • eventType (TEKST, Optioneel): Het type evenement. Toegestane waarden: default, focusTime, outOfOffice, workingLocation, enz. Zie de Google Calendar API-documentatie voor de volledige lijst. Geef slechts één evenementtype op

Uitvoer: Geeft het aangemaakte evenement terug met de volgende structuur:

  • id: Evenement-ID

  • summary: Evenementtitel

  • beschrijving: Evenementbeschrijving

  • start: Starttijdinformatie met dateTime en timeZone

  • end: Eindtijdinformatie met dateTime en timeZone

  • location: Evenementlocatie

  • attendees: Array van deelnemerobjecten met e-mailadressen

  • recurrence: Herhalingsregels indien van toepassing

  • htmlLink: Link om het evenement te bekijken in Google Agenda

  • created: Aanmaak-tijdstempel

  • updated: Tijdstempel van de laatste update

Evenement bijwerken

googlecalendar.updateEvent

Werkt een evenement bij Vereist bevestiging: Ja Parameters:

  • eventId (TEKST, Vereist): id van het evenement

  • eindTijd (TEKST, Optioneel): Eindtijd in RFC3339-formaat (bijv. ‘2025-03-15T10:00:00+01:00’)

  • startTijd (TEKST, Optioneel): Nieuwe starttijd in RFC3339-formaat (bijv. ‘2025-03-15T09:00:00+01:00’)

  • calendarId (TEKST, Vereist): De id van de agenda (bijv. ‘primary’ voor de hoofdagenda)

  • timeZone (TEKST, Optioneel): Nieuwe tijdzone (bijv. ‘America/New_York’)

  • eventTitle (TEKST, Optioneel): Nieuwe titel van het evenement (optioneel)

  • attendees (TEKST, Optioneel): Nieuwe lijst met e-mailadressen van deelnemers (optioneel)

  • beschrijving (TEKST, Optioneel): Nieuwe beschrijving van het evenement (optioneel)

  • location (TEKST, Optioneel): Nieuwe locatie van het evenement (optioneel)

  • sendUpdates (TEKST, Optioneel): Nieuw beleid voor het al dan niet verzenden van meldingen (‘all’, ‘externalOnly’, ‘none’) (optioneel)

  • recurrence (TEKST, Optioneel): Nieuwe lijst van RRULE-, EXRULE-, RDATE- en EXDATE-regels voor een terugkerend evenement, zoals gespecificeerd in RFC5545. Let op: DTSTART- en DTEND-regels zijn niet toegestaan. De scheiding tussen regels is een spatie.

  • eventType (TEKST, Optioneel): Het type evenement om bij te werken. Toegestane waarden: default, focusTime, outOfOffice, workingLocation, enz. Zie de Google Calendar API-documentatie voor de volledige lijst. Geef op als een door komma’s gescheiden lijst.

Uitvoer: Geeft het bijgewerkte evenement terug met de nieuwe details

Evenement ophalen

googlecalendar.getEvent

Haalt een evenement op Vereist bevestiging: Nee Parameters:

  • eventId (TEKST, Vereist): De id van het specifieke evenement dat opgehaald moet worden

  • calendarId (TEKST, Vereist): De id van de agenda (kan ‘primary’ gebruiken voor de primaire agenda van de gebruiker)

Uitvoer: Geeft de evenementdetails terug inclusief alle eigenschappen en metadata

Zoek naar evenementen

googlecalendar.searchforEvents

Haalt agendagebeurtenissen op via zoekopdracht Vereist bevestiging: Nee Parameters:

  • maxResults (TEKST, Optioneel): Maximale aantal resultaten om terug te geven (optioneel, standaard: 10)

  • searchQuery (TEKST, Optioneel): Bij gebruik van het zoekveld voor agendagebeurtenissen, voer specifieke en relevante trefwoorden in die waarschijnlijk voorkomen in de volgende velden:

    Belangrijk: VOEG GEEN algemene synoniemen voor evenement toe (zoals afspraak, vergadering, gesprek) in de zoekopdracht.

    • Samenvatting of titel: trefwoorden die het evenement beschrijven, bijv. “Projectvergadering”, “Teamlunch”

    • Beschrijving: termen gerelateerd aan de inhoud of het doel van het evenement, bijv. “budgetbespreking”

    • Locatie: naam van de locatie, bijv. “Vergaderzaal A”

    • Deelnemers: namen of e-mailadressen, bijv. [email protected]

    • Organisator: naam of e-mail van de organisator, bijv. [email protected]

    • Eigenschappen werkplek: kantooretiketten of gebouw-ID’s indien van toepassing

  • endDate (TEKST, Optioneel): Bovengrens (exclusief) voor de starttijd van een evenement om op te filteren. Moet RFC3339 zijn met tijdzone-offset. Als de startdatum is ingesteld, moet de einddatum groter zijn dan de startdatum.

  • calendarId (TEKST, Vereist): De id van de agenda om te doorzoeken (gebruik ‘primary’ voor de primaire agenda van de gebruiker)

  • startDate (TEKST, Optioneel): Ondergrens (exclusief) voor de eindtijd van een evenement om op te filteren. Moet RFC3339 zijn met tijdzone-offset. Als de einddatum is ingesteld, moet de startdatum kleiner zijn dan de einddatum.

  • desc (BOOLEAN, Optioneel): Selecteer of de resultaten in aflopende volgorde moeten worden weergegeven (starttijd).

  • eventType (TEKST, Optioneel): Het type evenement om op te filteren. Toegestane waarden: default, focusTime, outOfOffice, workingLocation, enz. Geef slechts één enkel evenementtype.

Uitvoer: Geeft een array van evenementen terug die overeenkomen met de zoekcriteria

Evenement verwijderen

googlecalendar.deleteEvent

Verwijdert een evenement Vereist bevestiging: Ja Parameters:

  • eventId (TEKST, Vereist): id van het evenement dat verwijderd wordt. Voor evenementreeksen geldt dat als je een evenementinstantie-id opgeeft, alleen die instantie wordt verwijderd, en als je de master-id van een terugkerend evenement opgeeft, de gehele reeks wordt verwijderd.

    • Voor een evenementinstantie-id van een terugkerend evenement zoals 7hagg0gtspd2b03lm8i3g4irr0_20250318T160000Z, is het gedeelte tot de eerste _ de master-id van het evenement.

  • calendarId (TEKST, Vereist): De id van de agenda (bijv. ‘primary’ voor de hoofdagenda)

Uitvoer: Geeft een bevestiging van de verwijdering terug

Agenda’s weergeven

googlecalendar.listCalendars

Toont alle agenda’s die toegankelijk zijn voor de geauthenticeerde gebruiker via de Google Calendar API /users/me/calendarList endpoint. Vereist bevestiging: Nee Parameters:

  • maxResults (TEKST, Optioneel): Maximale aantal items om terug te geven op één resultaatpagina (standaard: 100, max: 250).

  • minAccessRole (SELECT, Optioneel): Beperkt resultaten tot agenda’s waarbij de gebruiker ten minste deze toegangsrol heeft. Toegestane waarden: freeBusyReader, reader, writer, owner.

  • pageToken (TEKST, Optioneel): Token dat specificeert welke resultaatpagina moet worden geretourneerd (voor paginering).

  • showDeleted (BOOLEAN, Optioneel): Of verwijderde agenda-lijstitems moeten worden opgenomen in het resultaat (standaard: false).

  • showHidden (BOOLEAN, Optioneel): Of verborgen items moeten worden weergegeven (standaard: false).

  • syncToken (TEKST, Optioneel): Voor incrementele synchronisatie: retourneer alleen items die zijn gewijzigd sinds het vorige verzoek met deze token. Kan niet samen met minAccessRole worden gebruikt.

Uitvoer: Geeft een array van agenda’s terug met de volgende structuur:

  • id: Agenda-ID

  • summary: Agenda-naam

  • beschrijving: Agenda-beschrijving

  • timeZone: Agenda-tijdzone

  • accessRole: Toegangsrol van de gebruiker voor deze agenda

  • backgroundColor: Agenda-kleur

  • foregroundColor: Tekstkleur voor deze agenda

  • selected: Of deze agenda geselecteerd is

  • primary: Of dit de primaire agenda van de gebruiker is

Vrij/bezet voor agenda opvragen

googlecalendar.getFreeBusyforCalendar

Haalt vrij-/bezetinformatie op voor één of meerdere agenda’s over een opgegeven tijdsbereik met behulp van de Google Calendar API /freeBusy endpoint. Vereist bevestiging: Nee Parameters:

  • timeMin (TEKST, Vereist): RFC3339-tijdstempel voor het begin van het te controleren tijdsbereik (inclusief). Voorbeeld: 2025-05-15T08:00:00Z

  • timeMax (TEKST, Vereist): RFC3339-tijdstempel voor het einde van het te controleren tijdsbereik (exclusief). Voorbeeld: 2025-05-15T18:00:00Z

  • timeZone (TEKST, Optioneel): Tijdzone voor de reactie (optioneel, standaard UTC). Voorbeeld: Europe/Berlin

  • items (TEKST, Vereist): Lijst met agenda-IDs om te controleren (bijv. e-mails, resource-ID’s of ‘primary’). Voer in als een door komma’s gescheiden lijst.

Uitvoer: Geeft vrij-/bezetinformatie terug met de volgende structuur:

  • kind: API-resourcetype

  • timeMin: Begin van het opgevraagde bereik

  • timeMax: Einde van het opgevraagde bereik

  • calendars: Object met vrij-/bezetinformatie voor elke opgevraagde agenda, inclusief:

    • busy: Array van tijdsintervallen waarin de agenda bezet is

    • errors: Eventuele fouten die voor deze agenda zijn opgetreden

Triggers

Nieuw evenement

googlecalendar.newEvent

Wordt geactiveerd wanneer nieuwe agendagebeurtenissen worden aangemaakt in opgegeven agenda’s Vereist bevestiging: Nee Parameters:

  • calendarId (TEKST, Optioneel): ID van de agenda die moet worden bewaakt op nieuwe evenementen.

  • daysToInclude (TEKST, Optioneel): Aantal dagen in de toekomst om naar evenementen te zoeken. Standaard is 30 dagen

Uitvoer: Geeft informatie over nieuw aangemaakte evenementen

Evenement start

googlecalendar.eventStart

Wordt geactiveerd wanneer evenementen binnen een gespecificeerd tijdsvenster op het punt staan te beginnen Vereist bevestiging: Nee Parameters:

  • calendarId (TEKST, Optioneel): ID van de agenda om te bewaken. Standaard je primaire agenda als niet gespecificeerd

  • minuteBefore (TEKST, Vereist): Aantal minuten voordat een evenement begint om de workflow te activeren. Standaard is 15 minuten

Uitvoer: Geeft informatie over aankomende evenementen

Nieuw evenement dat overeenkomt met zoekopdracht

googlecalendar.newEventMatchingSearch

Wordt geactiveerd wanneer nieuwe agendagebeurtenissen die overeenkomen met de opgegeven zoekopdracht worden aangemaakt Vereist bevestiging: Nee Parameters:

  • calendarId (TEKST, Optioneel): ID van de agenda die moet worden bewaakt op nieuwe evenementen.

  • daysToInclude (NUMMER, Optioneel): Aantal dagen in de toekomst om naar evenementen te zoeken. Standaard is 30 dagen

  • searchQuery (TEKST, Vereist): Tekst om in evenementonderwerpen te zoeken. Voorbeelden: ‘Meeting’, ‘Review’, ‘Project kickoff’

Uitvoer: Geeft informatie over evenementen die overeenkomen met de zoekcriteria

Veelvoorkomende gebruikssituaties

  • Gegevensbeheer — Beheer en organiseer je Google Agenda-gegevens

  • Automatisering — Automatiseer workflows met Google Agenda

  • Rapportage — Genereer inzichten en rapporten

  • Integratie — Verbind Google Agenda met andere tools

Beste praktijken

1

Aan de slag — Stap 1

Schakel de Google Agenda-integratie in in de instellingen van je werkruimte

2

Aan de slag — Stap 2

Authenticeer met OAuth

3

Aan de slag — Stap 3

Test de verbinding met een eenvoudige leesbewerking

4

Aan de slag — Stap 4

Verken beschikbare acties voor uw gebruikssituatie

Belangrijke overwegingen:

  • Zorg voor de juiste authenticatiegegevens

  • Respecteer rate limits en API-quotums

  • Controleer instellingen voor gegevensprivacy

  • Test bewerkingen eerst in een veilige omgeving

Probleemoplossing

Probleem
Oplossing

Authenticatie mislukt

Controleer uw OAuth-gegevens

Rate limit overschreden

Verminder de frequentie van verzoeken

Gegevens niet gevonden

Controleer machtigingen en beschikbaarheid van gegevens

Verbindingstime-out

Controleer netwerkconnectiviteit

Ondersteuning

Voor aanvullende hulp bij de Google Agenda-integratie, neem contact op met [email protected]

Gerelateerde integraties: Google Analytics · Google Docs

VorigeMonday.comVolgendeGoogle Analytics