mirror of
https://github.com/n8n-io/n8n-docs.git
synced 2026-03-27 09:28:43 +07:00
Add info on recurring events to Google Calendar docs (#2759)
This commit is contained in:
Justin Ellingwood
committed by
GitHub
GitHub
parent
d6f4846dc4
commit
98cbf02b64
@@ -0,0 +1,38 @@
|
||||
---
|
||||
#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4
|
||||
title: Google Calendar Calendar operations
|
||||
description: Documentation for the Calendar operations in Google Calendar node in n8n, a workflow automation platform. Includes details of operations and configuration, and links to examples and credentials information.
|
||||
contentType: integration
|
||||
priority: high
|
||||
---
|
||||
|
||||
<!-- vale Vale.Repetition = NO -->
|
||||
<!-- vale from-write-good.Illusions = NO -->
|
||||
# Google Calendar Calendar operations
|
||||
<!-- vale from-write-good.Illusions = YES -->
|
||||
<!-- vale Vale.Repetition = YES -->
|
||||
|
||||
Use this operation to check availability in a calendar in Google Calendar. Refer to [Google Calendar](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/) for more information on the Google Calendar node itself.
|
||||
|
||||
## Availability
|
||||
|
||||
Use this operation to check if a time-slot is available in a calendar.
|
||||
|
||||
Enter these parameters:
|
||||
|
||||
- **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google/).
|
||||
- **Resource**: Select **Calendar**.
|
||||
- **Operation**: Select **Availability**.
|
||||
- **Calendar**: Choose a calendar you want to check against. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
|
||||
- **Start Time**: The start time for the time-slot you want to check. By default, uses an expression evaluating to the current time (`{{ $now }}`).
|
||||
- **End Time**: The end time for the time-slot you want to check. By default, uses an expression evaluating to an hour from now (`{{ $now.plus(1, 'hour') }}`).
|
||||
|
||||
### Options
|
||||
|
||||
- **Output Format**: Select the format for the availability information:
|
||||
- **Availability**: Returns if there are already events overlapping with the given time slot or not.
|
||||
- **Booked Slots**: Returns the booked slots.
|
||||
- **RAW**: Returns the RAW data from the API.
|
||||
- **Timezone**: The timezone used in the response. By default, uses the n8n timezone.
|
||||
|
||||
Refer to the [Freebusy: query | Google Calendar](https://developers.google.com/calendar/api/v3/reference/freebusy/query){:target=_blank .external-link} API documentation for more information.
|
||||
@@ -0,0 +1,176 @@
|
||||
---
|
||||
#https://www.notion.so/n8n/Frontmatter-432c2b8dff1f43d4b1c8d20075510fe4
|
||||
title: Google Calendar Event operations
|
||||
description: Documentation for the Event operations in Google Calendar node in n8n, a workflow automation platform. Includes details of operations and configuration, and links to examples and credentials information.
|
||||
contentType: integration
|
||||
priority: high
|
||||
---
|
||||
|
||||
# Google Calendar Event operations
|
||||
|
||||
Use these operations to create, delete, get, and update events in Google Calendar. Refer to [Google Calendar](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/) for more information on the Google Calendar node itself.
|
||||
|
||||
## Create
|
||||
|
||||
Use this operation to add an event to a Google Calendar.
|
||||
|
||||
Enter these parameters:
|
||||
|
||||
- **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google/).
|
||||
- **Resource**: Select **Event**.
|
||||
- **Operation**: Select **Create**.
|
||||
- **Calendar**: Choose a calendar you want to add an event to. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
|
||||
- **Start Time**: The start time for the event. By default, uses an expression evaluating to the current time (`{{ $now }}`).
|
||||
- **End Time**: The end time for the event. By default, this uses an expression evaluating to an hour from now (`{{ $now.plus(1, 'hour') }}`).
|
||||
- **Use Default Reminders**: Whether to enable default reminders for the event according to the calendar configuration.
|
||||
|
||||
### Options
|
||||
|
||||
- **All Day**: Whether the event is all day or not.
|
||||
- **Attendees**: Attendees to invite to the event.
|
||||
- **Color Name or ID**: The color of the event. Choose from the list or specify the ID using an expression.
|
||||
- **Conference Data**: Creates a conference link (Hangouts, Meet, etc.) and attaches it to the event.
|
||||
- **Description**: A description for the event.
|
||||
- **Guests Can Invite Others**: Whether attendees other than the organizer can invite others to the event.
|
||||
<!-- vale from-write-good.TooWordy = NO -->
|
||||
- **Guests Can Modify**: Whether attendees other than the organizer can modify the event.
|
||||
<!-- vale from-write-good.TooWordy = YES -->
|
||||
- **Guests Can See Other Guests**: Whether attendees other than the organizer can see who the event's attendees are.
|
||||
- **ID**: Opaque identifier of the event.
|
||||
- **Location**: Geographic location of the event as free-form text.
|
||||
- **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
|
||||
- **Repeat Frequency**: The repetition interval for recurring events.
|
||||
- **Repeat How Many Times?**: The number of instances to create for recurring events.
|
||||
- **Repeat Until**: The date at which recurring events should stop.
|
||||
<!-- vale from-write-good.Weasel = NO -->
|
||||
- **RRULE**: Recurrence rule. When set, ignores the Repeat Frequency, Repeat How Many Times, and Repeat Until parameters.
|
||||
<!-- vale from-write-good.Weasel = YES -->
|
||||
- **Send Updates**: Whether to send notifications about the creation of the new event.
|
||||
- **Show Me As**: Whether the event blocks time on the calendar.
|
||||
- **Summary**: The title of the event.
|
||||
|
||||
Refer to the [Events: insert | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/insert){:target=_blank .external-link} API documentation for more information.
|
||||
|
||||
## Delete
|
||||
|
||||
Use this operation to delete an event from a Google Calendar.
|
||||
|
||||
Enter these parameters:
|
||||
|
||||
- **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google/).
|
||||
- **Resource**: Select **Event**.
|
||||
- **Operation**: Select **Delete**.
|
||||
- **Calendar**: Choose a calendar you want to delete an event from. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
|
||||
- **Event ID**: The ID of the event to delete.
|
||||
|
||||
### Options
|
||||
|
||||
- **Send Updates**: Whether to send notifications about the deletion of the event.
|
||||
|
||||
Refer to the [Events: delete | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/delete){:target=_blank .external-link} API documentation for more information.
|
||||
|
||||
## Get
|
||||
|
||||
Use this operation to retrieve an event from a Google Calendar.
|
||||
|
||||
Enter these parameters:
|
||||
|
||||
- **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google/).
|
||||
- **Resource**: Select **Event**.
|
||||
- **Operation**: Select **Get**.
|
||||
- **Calendar**: Choose a calendar you want to get an event from. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
|
||||
- **Event ID**: The ID of the event to get.
|
||||
|
||||
### Options
|
||||
|
||||
- **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
|
||||
- **Return Next Instance of Recurrent Event**: Whether to return the next instance of a recurring event instead of the event itself.
|
||||
- **Timezone**: The timezone used in the response. By default, uses the n8n timezone.
|
||||
|
||||
Refer to the [Events: get | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/get){:target=_blank .external-link} API documentation for more information.
|
||||
|
||||
<!-- vale from-write-good.Weasel = NO -->
|
||||
## Get Many
|
||||
<!-- vale from-write-good.Weasel = YES -->
|
||||
|
||||
Use this operation to retrieve more than one event from a Google Calendar.
|
||||
|
||||
Enter these parameters:
|
||||
|
||||
- **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google/).
|
||||
- **Resource**: Select **Event**.
|
||||
- **Operation**: Select **Get Many**.
|
||||
- **Calendar**: Choose a calendar you want to get an event from. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
|
||||
- **Return All**: Whether to return all results or only up to a given limit.
|
||||
- **Limit**: (When "Return All" isn't selected) The maximum number of results to return.
|
||||
- **After**: Retrieve events that occur after this time. At least part of the event must be after this time. By default, this uses an expression evaluating to the current time (`{{ $now }}`). Switch the field to "fixed" to select a date from a date widget.
|
||||
- **Before**: Retrieve events that occur before this time. At least part of the event must be before this time. By default, this uses an expression evaluating to the current time plus a week (`{{ $now.plus({ week: 1 }) }}`). Switch the field to "fixed" to select a date from a date widget.
|
||||
|
||||
### Options
|
||||
|
||||
- **Fields**: Specify the fields to return. By default, returns a set of commonly used fields predefined by Google. Use "*" to return all fields. You can find out more in [Google Calendar's documentation on working with partial resources](https://developers.google.com/calendar/api/guides/performance#partial).
|
||||
<!-- vale Vale.Spelling = NO -->
|
||||
- **iCalUID**: Specifies an event ID (in the iCalendar format) to include in the response.
|
||||
<!-- vale Vale.Spelling = YES -->
|
||||
- **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
|
||||
- **Order By**: The order to use for the events in the response.
|
||||
- **Query**: Free text search terms to find events that match. This searches all fields except for extended properties.
|
||||
- **Recurring Event Handling**: What to do for recurring events:
|
||||
- **All Occurrences**: Return all instances of the recurring event for the specified time range.
|
||||
- **First Occurrence**: Return the first event of a recurring event within the specified time range.
|
||||
- **Next Occurrence**: Return the next instance of a recurring event within the specified time range.
|
||||
- **Show Deleted**: Whether to include deleted events (with status equal to "cancelled") in the results.
|
||||
- **Show Hidden Invitations**: Whether to include hidden invitations in the results.
|
||||
- **Timezone**: The timezone used in the response. By default, uses the n8n timezone.
|
||||
- **Updated Min**: The lower bounds for an event's last modification time (as an [RFC 3339 timestamp](https://datatracker.ietf.org/doc/html/rfc3339))
|
||||
|
||||
Refer to the [Events: list | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/list){:target=_blank .external-link} API documentation for more information.
|
||||
|
||||
## Update
|
||||
|
||||
Use this operation to update an event in a Google Calendar.
|
||||
|
||||
Enter these parameters:
|
||||
|
||||
- **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google/).
|
||||
- **Resource**: Select **Event**.
|
||||
- **Operation**: Select **Update**.
|
||||
- **Calendar**: Choose a calendar you want to add an event to. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
|
||||
- **Event ID**: The ID of the event to update.
|
||||
<!-- vale from-write-good.TooWordy = NO -->
|
||||
- **Modify**: For recurring events, choose whether to update the recurring event or a specific instance of the recurring event.
|
||||
<!-- vale from-write-good.TooWordy = YES -->
|
||||
- **Use Default Reminders**: Whether to enable default reminders for the event according to the calendar configuration.
|
||||
- **Update Fields**: The fields of the event to update:
|
||||
- **All Day**: Whether the event is all day or not.
|
||||
- **Attendees**: Attendees to invite to the event. You can choose to either add attendees or replace the existing attendee list.
|
||||
- **Color Name or ID**: The color of the event. Choose from the list or specify the ID using an expression.
|
||||
- **Description**: A description for the event.
|
||||
- **End**: The end time of the event.
|
||||
- **Guests Can Invite Others**: Whether attendees other than the organizer can invite others to the event.
|
||||
<!-- vale from-write-good.TooWordy = NO -->
|
||||
- **Guests Can Modify**: Whether attendees other than the organizer can make changes to the event.
|
||||
<!-- vale from-write-good.TooWordy = YES -->
|
||||
- **Guests Can See Other Guests**: Whether attendees other than the organizer can see who the event's attendees are.
|
||||
- **ID**: Opaque identifier of the event.
|
||||
- **Location**: Geographic location of the event as free-form text.
|
||||
- **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
|
||||
- **Repeat Frequency**: The repetition interval for recurring events.
|
||||
- **Repeat How Many Times?**: The number of instances to create for recurring events.
|
||||
- **Repeat Until**: The date at which recurring events should stop.
|
||||
<!-- vale from-write-good.Weasel = NO -->
|
||||
- **RRULE**: Recurrence rule. When set, ignores the Repeat Frequency, Repeat How Many Times, and Repeat Until parameters.
|
||||
<!-- vale from-write-good.Weasel = YES -->
|
||||
- **Send Updates**: Whether to send notifications about the creation of the new event.
|
||||
- **Show Me As**: Whether the event blocks time on the calendar.
|
||||
- **Start**: The start time of the event.
|
||||
- **Summary**: The title of the event.
|
||||
- **Visibility**: The visibility of the event:
|
||||
<!-- vale from-write-good.Passive = NO -->
|
||||
- **Confidential**: The event is private. This value is provided for compatibility.
|
||||
<!-- vale from-write-good.Passive = YES -->
|
||||
- **Default**: Uses the default visibility for events on the calendar.
|
||||
- **Public**: The event is public and the event details are visible to all readers of the calendar.
|
||||
- **Private**: The event is private and only event attendees may view event details.
|
||||
|
||||
Refer to the [Events: update | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/update){:target=_blank .external-link} API documentation for more information.
|
||||
@@ -19,13 +19,13 @@ Refer to [Google Calendar credentials](/integrations/builtin/credentials/google/
|
||||
## Operations
|
||||
|
||||
* **Calendar**
|
||||
* **Availability**: If a time-slot is available in a calendar
|
||||
* [**Availability**](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/calendar-operations/#availability): If a time-slot is available in a calendar
|
||||
* **Event**
|
||||
* **Create**: Add an event to calendar
|
||||
* **Delete**: Delete an event
|
||||
* **Get**: Retrieve an event
|
||||
* **Get Many**: Retrieve all events from a calendar
|
||||
* **Update**: Update an event
|
||||
* [**Create**](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations/#create): Add an event to calendar
|
||||
* [**Delete**](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations/#delete): Delete an event
|
||||
* [**Get**](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations/#get): Retrieve an event
|
||||
* [**Get Many**](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations/#get-many): Retrieve all events from a calendar
|
||||
* [**Update**](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations/#update): Update an event
|
||||
|
||||
## Templates and examples
|
||||
|
||||
@@ -530,7 +530,10 @@ nav:
|
||||
- Google BigQuery: integrations/builtin/app-nodes/n8n-nodes-base.googlebigquery.md
|
||||
- Google Books: integrations/builtin/app-nodes/n8n-nodes-base.googlebooks.md
|
||||
- Google Business Profile: integrations/builtin/app-nodes/n8n-nodes-base.googlebusinessprofile.md
|
||||
- Google Calendar: integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar.md
|
||||
- Google Calendar:
|
||||
- Google Calendar: integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/index.md
|
||||
- Calendar operations: integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/calendar-operations.md
|
||||
- Event operations: integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations.md
|
||||
- Google Chat: integrations/builtin/app-nodes/n8n-nodes-base.googlechat.md
|
||||
- Google Cloud Firestore: integrations/builtin/app-nodes/n8n-nodes-base.googlecloudfirestore.md
|
||||
- Google Cloud Natural Language: integrations/builtin/app-nodes/n8n-nodes-base.googlecloudnaturallanguage.md
|
||||
|
||||
Reference in New Issue
Block a user