Home > Application Reference > Google Calendar > Available Time Slots

This action queries a user’s Google Calendar and returns information around their availability given a specific date and time range. Enter a day, followed by a window of time to query against a particular user’s calendar.

Input Fields

  • Hourly Window - Choose a day and a time window.
    • Day (text): Day in the format of YYYY-MM-DD
    • Start Time (text): Start time in the format of HH:mm:ssZ.
    • End Time (text): End time in the format of HH:mm:ssZ
    • Time Zone (text): Choose a timezone - such as “US/Pacific” or “Europe/Paris” (see full list on wikipedia).
  • Event Duration - Choose the duration of your desired event.
    • Duration (Number): Duration of event in minutes.
  • Calendar
    • Calendar ID (text): The email address for the calendar you wish to query.

Output Fields

  • fields
    • Number of Available Slots (Number): The number of available ‘slots’ that are available on the user’s calendar for that time frame. What this means is that given your duration input, that this number of events with the given duration can fit in the user’s schedule. For example, if you have a gap of 45 minutes, and your duration input was 20 minutes, the Number of Available Slots returned would be two. However, if there are only four 20 minute slots available on a calendar, but the duration input is 30 minutes, then the Number of Available Slots will be 0, even though there is a total of 80 minutes available. Can think of this field as returning a number that represents ‘I can fit this many meetings of X duration into Y’s calendar.’
    • Total Minutes Available (Number): The total number of minutes available on the user’s calendar.
    • List of Busy Times (List of Objects): A list of ‘busy’ time objects. Each object returned in this list is a window of time from start to end that the user is busy/has events scheduled.
    • List of Available Times (List of Objects): A list of ‘available’ time objects. Each object returned in this list is a window of time from start to end that the user is available to schedule an event of duration that is less than or equal to the user’s input duration.