The Google Calendar List Calendar action is used to list all Google Calendars belonging to the user. This action allows all calendars owned or shared by the user to be dynamically displayed through your application. It is particularly preferred in scenarios involving multiple calendar management, meeting planning, and user selection.

Technical Specifications

• List Calendars: Returns all calendars that the user has access to.
• Parameter Compatibility:
  
  • settings (Object – required): Configuration information required for Google Calendar integration.
• Result: Returns multiple results (Many) → If the user has more than one calendar, all of them are listed.
• Value Binding: Results can be transferred to other actions (e.g., Get Event, Create Event) via the Symbol Picker.
• Web & Mobile Support: Works seamlessly on both web and mobile applications.

Google Calendar List Calendar Action Application Steps

1. Defining Actions in UI Design

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

2. Configuring Parameters

• settings (required): Select the defined settings for Google integration.

Usage Scenario: Listing User Calendars

In a business application, a user may have multiple calendars (e.g., “primary,” “work,” “project-x-team”). The user can select one of these calendars to create or view events.

Steps:

1. Add a Table element in UI Design.
2. When the “List Calendars” button is pressed, the Google Calendar List Calendar action is triggered.
3. The returned calendar list is displayed in the Select Box.
4. The user can use the selected calendar in other actions (e.g., Create Event, Get Event, Delete Event).

Google Calendar List Calendar Advanced Customizations

• Dynamic Selection: The user can select the desired calendar and link it to the Create Event action.
• Filtering: The returned calendars can be filtered for work/personal use.
• Chain Usage: The selected calendarId can be automatically transferred to the Google Calendar Get Event or Google Calendar Create Event action.

Technical Risks and Controls

• The settings parameter must not be empty.
• If the user's Google Calendar account is not properly connected, the calendar list will return empty.
• Shared calendars can only be viewed if access permission is granted.