Skip to content
Nappai Documentation

Google Calendar Loader

This component helps you bring events from your Google Calendar into your Nappai workflows. You can specify which calendar, the date range, and even search for specific events using keywords. The results are then available for use in other parts of your Nappai automation.

Relationship with Google Calendar API

This component connects directly to your Google Calendar using your Google account credentials. It uses the Google Calendar API to securely retrieve your calendar events. You’ll need to authorize Nappai to access your calendar the first time you use this component.

Inputs

  • Calendar: Choose the Google Calendar you want to retrieve events from. A refresh button is available to update the list of calendars.
  • Events to read: Specify how many events you want to retrieve (default is 10).
  • Query: Enter keywords to search for specific events (e.g., “meeting,” “project X”). Leave this blank to retrieve all events matching other criteria.
  • Min Range: Set the starting date and time for your search. Use the format YYYY-MM-DD HH:MM:SS AM/PM TZ (e.g., 2024-03-08 09:00:00 AM UTC). This field is a date picker for easier input.
  • Max Range: Set the ending date and time for your search. Use the format YYYY-MM-DD HH:MM:SS AM/PM TZ (e.g., 2024-03-08 05:00:00 PM UTC). This field is a date picker for easier input.
  • Credential: Select the Google account credentials you’ve already set up in Nappai to access your Google Calendar.

Outputs

The component outputs a list of events that match your search criteria. Each event contains information like the title, date, time, and description. This output can be used by other Nappai components to process and act upon the calendar events (e.g., send reminders, create tasks, update other systems).

Usage Example

Let’s say you want to get all meetings from your “Work” calendar next week. You would:

  1. Select “Work” from the Calendar dropdown.
  2. Set Events to read to a suitable number (e.g., 20).
  3. Leave the Query field blank.
  4. Set Min Range to the start of next week (e.g., 2024-03-11 00:00:00 AM UTC).
  5. Set Max Range to the end of next week (e.g., 2024-03-17 23:59:59 PM UTC).
  6. Select your Google account credentials under Credential.
  7. Run the component. The output will contain a list of your meetings.

Templates

[List of templates where the component is used - This section will be populated based on actual template usage.]

  • Google Calendar Modifier: This component allows you to create, update, and delete events in Google Calendar. Use this to act upon the events retrieved by the Google Calendar Loader.
  • Google Sheet Writer: Write the events data to a Google Sheet for further analysis or reporting.
  • Slack Message: Send a notification about upcoming events via Slack.

Tips and Best Practices

  • Start with a small number of events to read to test your configuration.
  • Use the query field to refine your search and get more specific results.
  • Ensure your date and time ranges are accurate to avoid missing events.
  • Regularly update your Google Calendar credentials if necessary.

Security Considerations

  • Only grant Nappai the necessary permissions to access your Google Calendar.
  • Regularly review the permissions granted to Nappai.
  • Use strong and unique passwords for your Google account.
  • Keep your Google account software updated.