Prerequisites
- Ensure a connected Google Calendar account exists for the user.
- The connected account must have permission in Google Calendar to add events.
- Google Calendar must be connected as a data source for Glean actions.
Supported parameters
| Parameter | Type | Description |
|---|---|---|
| Max results | Integer | Limits the number of calendar records returned by the action. |
| Min access role | String | Filters calendars so that only calendars at or above this access level are returned. |
| Show hidden | Boolean | When enabled, includes calendars that are marked as hidden. |
| Show deleted | Boolean | When enabled, includes calendars that have been deleted. |
| Min access role | String | Minimum access role the user must have for the returned calendars. Examples: “freeBusyReader” “owner” “reader” “writer” |
| Page token | String | Token for retrieving a specific page of results from a previous list operation. |
| Sync token | String | Sync token from a previous list request’s ‘nextSyncToken’ to retrieve only entries changed since the last sync. When provided, only ‘syncToken’ and optionally ‘pageToken’ are used; other filters are ignored. ‘minAccessRole’ cannot be combined with ‘syncToken’. |
Usage examples
- “Show me all my Google calendars so I can choose which one to use for my team’s weekly standup.”
- “List all calendars I have access to in my Google Calendar account.”
- “What calendars are available in my Google Calendar?”
Troubleshooting
No calendars are returned
No calendars are returned
- Possible cause: The underlying Google account has no calendars, the user doesn’t have access to the calendars, or hidden/deleted calendars are excluded from the results.
- Fix: Verify that the Google account has calendars and that the user has access to them. If needed, enable the parameters to include hidden and deleted calendars in the action’s configuration.
FAQs
Does this action modify calendars?
Does this action modify calendars?
No. List Google calendars is a read-only action that only retrieves calendar metadata.
Can I control which calendars are returned?
Can I control which calendars are returned?
Yes. Use the Min access role parameter to control which calendars qualify, and the Show hidden and Show deleted flags to include or exclude those calendars. You can also use the Max results parameter to cap how many calendars are returned in a single call.