Change an event
events_editChange an event the account organises, in place and in one call: its subject, body, location, start and end, how it shows, its privacy, reminders and video link, and its guests - addGuests invited, removeGuests taken off. Only what is named changes: the event keeps its id, every other guest's answer and its join link, a start named alone keeps its length and an end named alone keeps its start. Start and end are named as events_create names them, so naming both in the other form turns a timed event all-day or back, and are written in the person's own time zone as events_create writes them. What the account's provider lacks is refused with the reason, as on events_create, and so is a new body for an Outlook online meeting, whose join details it holds. Changing guests takes inviting allowed on the account. A whole series' start and end are its first occurrence's, and a change to a whole series holding occurrences changed apart from it is refused, naming each by when its series set it, so none of theirs is undone. Its provider sends a meeting's guests the change from the account's own address, as notify chooses. Like every write, the answer names the event's provider, its calendarId where its provider addresses it by one, and its webLink. Guests' own hours hold a change as they hold events_create: every guest's where its times change, an added guest's at its time otherwise.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| body | No | ||
| scope | No | For an occurrence of a recurring series: occurrence, where omitted, acts on that occurrence alone, series on its whole series. A series named by its own seriesId is refused unless series is passed. | |
| start | No | ||
| video | No | A Meet link on a Google account or a Teams link on a work Microsoft account, given back under joinUrl. | |
| notify | No | Who the provider tells: every guest where omitted, externalOnly only guests outside Google Calendar, none nobody. Outlook tells every guest of a meeting it makes, changes or cancels, so there only an answer goes untold. | |
| showAs | No | How it shows; Google shows busy or free alone. | |
| account | Yes | The connected account, by the address calendars_list names. | |
| eventId | Yes | The event's id, as events_list names it. | |
| privacy | No | ||
| subject | No | ||
| location | No | ||
| provider | No | The account's provider, as calendars_list names it; needed only where two connected accounts share an address. | |
| addGuests | No | Addresses to invite. | |
| reminders | No | Minutes before its start each reminder sounds, Outlook keeping one; empty for none. | |
| calendarId | No | The calendar holding the event, by the calendarId events_list names; a Google account's event outside its default calendar needs it. | |
| guestZones | No | A guest's own time zone, only as the person names it - never inferred from an address, a language or a provider. | |
| removeGuests | No | Guests to take off, by address. | |
| unusualHoursAgreed | No | True only once the person has agreed to send at the hours an answer named as unusual for a guest. |