
Google Calendar GetEvent
CertifiedFetch a Google Calendar event by ID
Google Calendar GetEvent
Fetch a Google Calendar event by ID
Retrieves a single event from a shared calendar using a service account. Supports attendee truncation via maxAttendees and toggling email fields with alwaysIncludeEmail (default false).
type: io.kestra.plugin.googleworkspace.calendar.GetEventExamples
id: googleworkspace_calendar_get_event
namespace: company.team
tasks:
- id: get_event
type: io.kestra.plugin.googleworkspace.calendar.GetEvent
serviceAccount: "{{ secret('GCP_SERVICE_ACCOUNT_JSON') }}"
calendarId: team@company.com
eventId: "abcdef123456"
maxAttendees: 50
alwaysIncludeEmail: true
Installation
Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:
kestractl plugins get io.kestra.plugin:plugin-googleworkspace --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
For Kestra CLI, replace LATEST with a specific version or version range to pin the plugin version.
Properties
calendarId *string
Calendar ID
Email-style calendar shared with the service account, e.g. team@company.com
eventId *string
Event ID
Identifier of the event to fetch
alwaysIncludeEmail booleanstring
falseInclude attendee emails
Whether organizer/attendee emails are returned; default false
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150maxAttendees integerstring
Maximum attendees
Upper bound of attendees returned; omit to use API default
readTimeout integerstring
120The read timeout for the request (in seconds)
scopes array
["https://www.googleapis.com/auth/calendar"]The GCP scopes to used
serviceAccount string
The GCP service account key
Outputs
event
Event
io.kestra.plugin.googleworkspace.calendar.models.Event
metadata object
Raw event metadata