The Google Calendar List Events action is used to list events in a Google Calendar. This action allows you to retrieve all events within specific date ranges in a user's calendar. It is particularly useful for meeting planning, event reminders, time management, and reporting scenarios.

Technical Specifications

• List Events: Returns events in the specified calendar (calendarId).
• Parameter Compatibility:
  
  • settings (Object – required): Configuration information required for Google Calendar integration.
  • calendarId (String – required): Calendar ID from which events will be retrieved.
  • startDate (DateTimeOffset – optional): The start date of the events.
  • endDate (DateTimeOffset – optional): The end date of the events.
  • resultCount (Int32 – optional): The maximum number of events to return.
  • query (String – optional): A filter to search for event names, descriptions, or other fields.
• Result: Returns multiple results (Many) → Lists more than one event.
• Value Binding: Fixed values can be assigned to parameters, or dynamic values can be bound via the Symbol Picker.
• Web & Mobile Support: Works in both web and mobile applications.

Google Calendar List Events Action Application Steps

1. Action Definition in UI Design

• Open your project on the Kuika platform.
• In the UI Design module, select the screen where you want to retrieve the event list.
• Add a button (e.g., “List Events”).
• Select the button and add the OnClick → Google → Google Calendar List Events action from the + ADD ACTION menu.

2. Configuring Parameters

• settings (required): Select the defined settings for Google integration.
• calendarId (required): E.g.: primary.
• startDate / endDate (optional): The date range for filtering events (e.g.: 2025-09-20T00:00:00).
• resultCount (optional): e.g., 10 → returns only 10 events.
• query (optional): Can be used to search for specific event names (e.g., “Meeting”).

Use Case: Listing Events from Calendar

In a business application, this action can be used when a user wants to see meetings scheduled within a specific date range.

Steps:

1. Add a Date Time Range for start and end dates in UI Design.
2. When the “List Events” button is clicked, the Google Calendar List Events action is triggered.
3. The returned events are displayed in a Table element.

Google Calendar List Events Advanced Customizations

• Dynamic Filtering: The event list can be automatically refreshed when the user selects a date range.
• Search Feature: Only events containing a specific word can be listed using the query parameter.
• Chain Usage: The eventId selected from the list can be passed to the Google Calendar Get Event or Delete Event actions.

Technical Risks and Controls

• If calendarId is not entered correctly, no results will be returned.
• If startDate / endDate are incompatible or left blank, all events may be returned.
• If there are too many events, they should be limited using the resultCount parameter.