Calendar Service

Calendar

This service allows a script to access and modify the user's Google Calendar, including additional calendars that the user is subscribed to.

Classes

NameBrief description
CalendarRepresents a calendar that the user owns or is subscribed to.
CalendarAppAllows a script to read and update the user's Google Calendar.
CalendarEventRepresents a single calendar event.
CalendarEventSeriesRepresents a series of events (a recurring event).
ColorAn enum representing the named colors available in the Calendar service.
EventColorAn enum representing the named event colors available in the Calendar service.
EventGuestRepresents a guest of an event.
EventRecurrenceRepresents the recurrence settings for an event series.
EventTransparencyAn enum representing the transparency of an event.
EventTypeAn enum representing the type of an event.
GuestStatusAn enum representing the statuses a guest can have for an event.
RecurrenceRuleRepresents a recurrence rule for an event series.
VisibilityAn enum representing the visibility of an event.

Calendar

Methods

MethodReturn typeBrief description
createAllDayEvent(title, date)CalendarEventCreates a new all-day event.
createAllDayEvent(title, startDate, endDate)CalendarEventCreates a new all-day event that can span multiple days.
createAllDayEvent(title, startDate, endDate, options)CalendarEventCreates a new all-day event that can span multiple days.
createAllDayEvent(title, date, options)CalendarEventCreates a new all-day event.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesCreates a new all-day event series.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesCreates a new all-day event series.
createEvent(title, startTime, endTime)CalendarEventCreates a new event.
createEvent(title, startTime, endTime, options)CalendarEventCreates a new event.
createEventFromDescription(description)CalendarEventCreates an event from a free-form description.
createEventSeries(title, startTime, endTime, recurrence)CalendarEventSeriesCreates a new event series.
createEventSeries(title, startTime, endTime, recurrence, options)CalendarEventSeriesCreates a new event series.
deleteCalendar()voidDeletes the calendar permanently.
getColor()StringGets the color of the calendar.
getDescription()StringGets the description of the calendar.
getEventById(iCalId)CalendarEventGets the event with the given ID.
getEventSeriesById(iCalId)CalendarEventSeriesGets the event series with the given ID.
getEvents(startTime, endTime)CalendarEvent[]Gets all events that occur within a given time range.
getEvents(startTime, endTime, options)CalendarEvent[]Gets all events that occur within a given time range and meet the specified criteria.
getEventsForDay(date)CalendarEvent[]Gets all events that occur on a given day.
getEventsForDay(date, options)CalendarEvent[]Gets all events that occur on a given day and meet specified criteria.
getId()StringGets the ID of the calendar.
getName()StringGets the name of the calendar.
getTimeZone()StringGets the time zone of the calendar.
isHidden()BooleanDetermines whether the calendar is hidden in the user interface.
isMyPrimaryCalendar()BooleanDetermines whether the calendar is the primary calendar for the effective user.
isOwnedByMe()BooleanDetermines whether the calendar is owned by you.
isSelected()BooleanDetermines whether the calendar's events are displayed in the user interface.
setColor(color)CalendarSets the color of the calendar.
setDescription(description)CalendarSets the description of a calendar.
setHidden(hidden)CalendarSets whether the calendar is visible in the user interface.
setName(name)CalendarSets the name of the calendar.
setSelected(selected)CalendarSets whether the calendar's events are displayed in the user interface.
setTimeZone(timeZone)CalendarSets the time zone of the calendar.
unsubscribeFromCalendar()voidUnsubscribes the user from a calendar.

CalendarApp

Properties

PropertyTypeDescription
ColorColorAn enum representing the named colors available in the Calendar service.
EventColorEventColorAn enum representing the named event colors available in the Calendar service.
EventTransparencyEventTransparencyThe EventTransparency enumeration.
EventTypeEventTypeThe EventType enumeration.
GuestStatusGuestStatusAn enum representing the statuses a guest can have for an event.
MonthMonthAn enum representing the months of the year.
VisibilityVisibilityAn enum representing the visibility of an event.
WeekdayWeekdayAn enum representing the days of the week.

Methods

MethodReturn typeBrief description
createAllDayEvent(title, date)CalendarEventCreates a new all-day event.
createAllDayEvent(title, startDate, endDate)CalendarEventCreates a new all-day event that can span multiple days.
createAllDayEvent(title, startDate, endDate, options)CalendarEventCreates a new all-day event that can span multiple days.
createAllDayEvent(title, date, options)CalendarEventCreates a new all-day event.
createAllDayEventSeries(title, startDate, recurrence)CalendarEventSeriesCreates a new all-day event series.
createAllDayEventSeries(title, startDate, recurrence, options)CalendarEventSeriesCreates a new all-day event series.
createCalendar(name)CalendarCreates a new calendar, owned by the user.
createCalendar(name, options)CalendarCreates a new calendar, owned by the user.
createEvent(title, startTime, endTime)CalendarEventCreates a new event.
createEvent(title, startTime, endTime, options)CalendarEventCreates a new event.
createEventFromDescription(description)CalendarEventCreates an event from a free-form description.
createEventSeries(title, startTime, endTime, recurrence)CalendarEventSeriesCreates a new event series.
createEventSeries(title, startTime, endTime, recurrence, options)CalendarEventSeriesCreates a new event series.
getAllCalendars()Calendar[]Gets all calendars that the user owns or is subscribed to.
getAllOwnedCalendars()Calendar[]Gets all calendars that the user owns.
getCalendarById(id)CalendarGets the calendar with the given ID.
getCalendarsByName(name)Calendar[]Gets all calendars with a given name that the user owns or is subscribed to.
getColor()StringGets the color of the calendar.
getDefaultCalendar()CalendarGets the user's default calendar.
getDescription()StringGets the description of the calendar.
getEventById(iCalId)CalendarEventGets the event with the given ID.
getEventSeriesById(iCalId)CalendarEventSeriesGets the event series with the given ID.
getEvents(startTime, endTime)CalendarEvent[]Gets all events that occur within a given time range.
getEvents(startTime, endTime, options)CalendarEvent[]Gets all events that occur within a given time range and meet the specified criteria.
getEventsForDay(date)CalendarEvent[]Gets all events that occur on a given day.
getEventsForDay(date, options)CalendarEvent[]Gets all events that occur on a given day and meet specified criteria.
getId()StringGets the ID of the calendar.
getName()StringGets the name of the calendar.
getOwnedCalendarById(id)CalendarGets the calendar with the given ID, if the user owns it.
getOwnedCalendarsByName(name)Calendar[]Gets all calendars with a given name that the user owns.
getTimeZone()StringGets the time zone of the calendar.
isHidden()BooleanDetermines whether the calendar is hidden in the user interface.
isMyPrimaryCalendar()BooleanDetermines whether the calendar is the primary calendar for the effective user.
isOwnedByMe()BooleanDetermines whether the calendar is owned by you.
isSelected()BooleanDetermines whether the calendar's events are displayed in the user interface.
newRecurrence()EventRecurrenceCreates a new recurrence object, which can be used to create rules for event recurrence.
setColor(color)CalendarSets the color of the calendar.
setDescription(description)CalendarSets the description of a calendar.
setHidden(hidden)CalendarSets whether the calendar is visible in the user interface.
setName(name)CalendarSets the name of the calendar.
setSelected(selected)CalendarSets whether the calendar's events are displayed in the user interface.
setTimeZone(timeZone)CalendarSets the time zone of the calendar.
subscribeToCalendar(id)CalendarSubscribes the user to the calendar with the given ID, if the user is allowed to subscribe.
subscribeToCalendar(id, options)CalendarSubscribes the user to the calendar with the given ID, if the user is allowed to subscribe.

CalendarEvent

Methods

MethodReturn typeBrief description
addEmailReminder(minutesBefore)CalendarEventAdds a new email reminder to the event.
addGuest(email)CalendarEventAdds a guest to the event.
addPopupReminder(minutesBefore)CalendarEventAdds a new pop-up notification to the event.
addSmsReminder(minutesBefore)CalendarEventAdds a new SMS reminder to the event.
anyoneCanAddSelf()BooleanDetermines whether people can add themselves as guests to a Calendar event.
deleteEvent()voidDeletes a Calendar event.
deleteTag(key)CalendarEventDeletes a key/value tag from the event.
getAllDayEndDate()DateGets the date on which this all-day calendar event ends.
getAllDayStartDate()DateGets the date on which this all-day calendar event begins.
getAllTagKeys()String[]Gets all keys for tags that have been set on the event.
getColor()StringReturns the color of the calendar event.
getCreators()String[]Gets the creators of an event.
getDateCreated()DateGets the date the event was created.
getDescription()StringGets the description of the event.
getEmailReminders()Integer[]Gets the minute values for all email reminders for the event.
getEndTime()DateGets the date and time at which this calendar event ends.
getEventSeries()CalendarEventSeriesGets the series of recurring events that this event belongs to.
getEventType()EventTypeGets the EventType of this event.
getGuestByEmail(email)EventGuestGets a guest by email address.
getGuestList()EventGuest[]Gets the guests for the event, not including the event owner.
getGuestList(includeOwner)EventGuest[]Gets the guests for the event, potentially including the event owners.
getId()StringGets the unique iCalUID of the event.
getLastUpdated()DateGets the date the event was last updated.
getLocation()StringGets the location of the event.
getMyStatus()GuestStatusGets the event status (such as attending or invited) of the effective user.
getOriginalCalendarId()StringGet the ID of the calendar where this event was originally created.
getPopupReminders()Integer[]Gets the minute values for all pop-up reminders for the event.
getSmsReminders()Integer[]Gets the minute values for all SMS reminders for the event.
getStartTime()DateGets the date and time at which this calendar event begins.
getTag(key)StringGets a tag value of the event.
getTitle()StringGets the title of the event.
getTransparency()EventTransparencyGets the transparency of the event.
getVisibility()VisibilityGets the visibility of the event.
guestsCanInviteOthers()BooleanDetermines whether guests can invite other guests.
guestsCanModify()BooleanDetermines whether guests can modify the event.
guestsCanSeeGuests()BooleanDetermines whether guests can see other guests.
isAllDayEvent()BooleanDetermines whether this is an all-day event.
isOwnedByMe()BooleanDetermines whether you're the owner of the event.
isRecurringEvent()BooleanDetermines whether the event is part of an event series.
removeAllReminders()CalendarEventRemoves all reminders from the event.
removeGuest(email)CalendarEventRemoves a guest from the event.
resetRemindersToDefault()CalendarEventResets the reminders using the calendar's default settings.
setAllDayDate(date)CalendarEventSets the date of the event.
setAllDayDates(startDate, endDate)CalendarEventSets the dates of the event.
setAnyoneCanAddSelf(anyoneCanAddSelf)CalendarEventSets whether non-guests can add themselves to the event.
setColor(color)CalendarEventSets the color of the calendar event.
setDescription(description)CalendarEventSets the description of the event.
setGuestsCanInviteOthers(guestsCanInviteOthers)CalendarEventSets whether guests can invite other guests.
setGuestsCanModify(guestsCanModify)CalendarEventSets whether guests can modify the event.
setGuestsCanSeeGuests(guestsCanSeeGuests)CalendarEventSets whether guests can see other guests.
setLocation(location)CalendarEventSets the location of the event.
setMyStatus(status)CalendarEventSets the event status (such as attending or invited) of the effective user.
setTag(key, value)CalendarEventSets a key/value tag on the event, for storing custom metadata.
setTime(startTime, endTime)CalendarEventSets the dates and times for the start and end of the event.
setTitle(title)CalendarEventSets the title of the event.
setTransparency(transparency)CalendarEventSets the transparency of the event.
setVisibility(visibility)CalendarEventSets the visibility of the event.

CalendarEventSeries

Methods

MethodReturn typeBrief description
addEmailReminder(minutesBefore)CalendarEventSeriesAdds a new email reminder to the event.
addGuest(email)CalendarEventSeriesAdds a guest to the event.
addPopupReminder(minutesBefore)CalendarEventSeriesAdds a new pop-up notification to the event.
addSmsReminder(minutesBefore)CalendarEventSeriesAdds a new SMS reminder to the event.
anyoneCanAddSelf()BooleanDetermines whether people can add themselves as guests to a Calendar event.
deleteEventSeries()voidDeletes the event series.
deleteTag(key)CalendarEventSeriesDeletes a key/value tag from the event.
getAllTagKeys()String[]Gets all keys for tags that have been set on the event.
getColor()StringReturns the color of the calendar event.
getCreators()String[]Gets the creators of an event.
getDateCreated()DateGets the date the event was created.
getDescription()StringGets the description of the event.
getEmailReminders()Integer[]Gets the minute values for all email reminders for the event.
getEventType()EventTypeGets the EventType of this event.
getGuestByEmail(email)EventGuestGets a guest by email address.
getGuestList()EventGuest[]Gets the guests for the event, not including the event owner.
getGuestList(includeOwner)EventGuest[]Gets the guests for the event, potentially including the event owners.
getId()StringGets the unique iCalUID of the event.
getLastUpdated()DateGets the date the event was last updated.
getLocation()StringGets the location of the event.
getMyStatus()GuestStatusGets the event status (such as attending or invited) of the effective user.
getOriginalCalendarId()StringGet the ID of the calendar where this event was originally created.
getPopupReminders()Integer[]Gets the minute values for all pop-up reminders for the event.
getSmsReminders()Integer[]Gets the minute values for all SMS reminders for the event.
getTag(key)StringGets a tag value of the event.
getTitle()StringGets the title of the event.
getTransparency()EventTransparencyGets the transparency of the event.
getVisibility()VisibilityGets the visibility of the event.
guestsCanInviteOthers()BooleanDetermines whether guests can invite other guests.
guestsCanModify()BooleanDetermines whether guests can modify the event.
guestsCanSeeGuests()BooleanDetermines whether guests can see other guests.
isOwnedByMe()BooleanDetermines whether you're the owner of the event.
removeAllReminders()CalendarEventSeriesRemoves all reminders from the event.
removeGuest(email)CalendarEventSeriesRemoves a guest from the event.
resetRemindersToDefault()CalendarEventSeriesResets the reminders using the calendar's default settings.
setAnyoneCanAddSelf(anyoneCanAddSelf)CalendarEventSeriesSets whether non-guests can add themselves to the event.
setColor(color)CalendarEventSeriesSets the color of the calendar event.
setDescription(description)CalendarEventSeriesSets the description of the event.
setGuestsCanInviteOthers(guestsCanInviteOthers)CalendarEventSeriesSets whether guests can invite other guests.
setGuestsCanModify(guestsCanModify)CalendarEventSeriesSets whether guests can modify the event.
setGuestsCanSeeGuests(guestsCanSeeGuests)CalendarEventSeriesSets whether guests can see other guests.
setLocation(location)CalendarEventSeriesSets the location of the event.
setMyStatus(status)CalendarEventSeriesSets the event status (such as attending or invited) of the effective user.
setRecurrence(recurrence, startDate)CalendarEventSeriesSets the recurrence rules for an all-day event series.
setRecurrence(recurrence, startTime, endTime)CalendarEventSeriesSets the recurrence rules for this event series.
setTag(key, value)CalendarEventSeriesSets a key/value tag on the event, for storing custom metadata.
setTitle(title)CalendarEventSeriesSets the title of the event.
setTransparency(transparency)CalendarEventSeriesSets the transparency of the event.
setVisibility(visibility)CalendarEventSeriesSets the visibility of the event.

Color

Properties

PropertyTypeDescription
BLUEEnum
Blue (#2952A3).
BROWNEnum
Brown (#8D6F47).
CHARCOALEnum
Charcoal (#4E5D6C).
CHESTNUTEnum
Chestnut (#865A5A).
GRAYEnum
Gray (#5A6986).
GREENEnum
Green (#0D7813).
INDIGOEnum
Indigo (#5229A3).
LIMEEnum
Lime (#528800).
MUSTARDEnum
Mustard (#88880E).
OLIVEEnum
Olive (#6E6E41).
ORANGEEnum
Orange (#BE6D00).
PINKEnum
Pink (#B1365F).
PLUMEnum
Plum (#705770).
PURPLEEnum
Purple (#7A367A).
REDEnum
Red (#A32929).
RED_ORANGEEnum
Red-Orange (#B1440E).
SEA_BLUEEnum
Sea Blue (#29527A).
SLATEEnum
Slate (#4A716C).
TEALEnum
Teal (#28754E).
TURQOISEEnum
Turquoise (#1B887A).
YELLOWEnum
Yellow (#AB8B00).

EventColor

Properties

PropertyTypeDescription
PALE_BLUEEnum
Pale Blue ("1"), referred to as "Peacock" in th Calendar UI.
PALE_GREENEnum
Pale Green ("2"), referred to as "Sage" in th Calendar UI.
MAUVEEnum
Mauve ("3"),, referred to as "Grape" in th Calendar UI.
PALE_REDEnum
Pale Red ("4"), referred to as "Flamingo" in th Calendar UI.
YELLOWEnum
Yellow ("5"), referred to as "Banana" in th Calendar UI.
ORANGEEnum
Orange ("6"), referred to as "Tangerine" in th Calendar UI.
CYANEnum
Cyan ("7"), referred to as "Lavender" in th Calendar UI.
GRAYEnum
Gray ("8"), referred to as "Graphite" in th Calendar UI.
BLUEEnum
Blue ("9"), referred to as "Blueberry" in th Calendar UI.
GREENEnum
Green ("10"), referred to as "Basil" in th Calendar UI.
REDEnum
Red ("11"), referred to as "Tomato" in th Calendar UI.

EventGuest

Methods

MethodReturn typeBrief description
getAdditionalGuests()IntegerGets the number of additional people that this guest has said are attending.
getEmail()StringGets the email address of the guest.
getGuestStatus()GuestStatusGets the status of the guest for the event.
getName()StringGets the name of the guest.

EventRecurrence

Methods

MethodReturn typeBrief description
addDailyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a daily basis.
addDailyRule()RecurrenceRuleAdds a rule that causes the event to recur on a daily basis.
addDate(date)EventRecurrenceAdds a rule that causes the event to recur on a specific date.
addDateExclusion(date)EventRecurrenceAdds a rule that excludes an occurrence for a specific date.
addMonthlyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a monthly basis.
addMonthlyRule()RecurrenceRuleAdds a rule that causes the event to recur on a monthly basis.
addWeeklyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a weekly basis.
addWeeklyRule()RecurrenceRuleAdds a rule that causes the event to recur on a weekly basis.
addYearlyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a yearly basis.
addYearlyRule()RecurrenceRuleAdds a rule that causes the event to recur on a yearly basis.
setTimeZone(timeZone)EventRecurrenceSets the time zone for this recurrence.

EventTransparency

Properties

PropertyTypeDescription
OPAQUEEnumThe event does block time on the calendar.
TRANSPARENTEnumThe event does not block time on the calendar.

EventType

Properties

PropertyTypeDescription
DEFAULTEnumThe event is a regular event.
BIRTHDAYEnumThe event is a special all-day event with an annual recurrence.
FOCUS_TIMEEnumThe event is a focus-time event.
FROM_GMAILEnumThe event is an event from Gmail.
OUT_OF_OFFICEEnumThe event is an out-of-office event.
WORKING_LOCATIONEnumThe event is a working location event.

GuestStatus

Properties

PropertyTypeDescription
INVITEDEnumThe guest has been invited, but has not indicated whether they are attending.
MAYBEEnumThe guest has indicated they might attend.
NOEnumThe guest has indicated they are not attending.
OWNEREnumThe guest is the owner of the event.
YESEnumThe guest has indicated they are attending.

RecurrenceRule

Methods

MethodReturn typeBrief description
addDailyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a daily basis.
addDailyRule()RecurrenceRuleAdds a rule that causes the event to recur on a daily basis.
addDate(date)EventRecurrenceAdds a rule that causes the event to recur on a specific date.
addDateExclusion(date)EventRecurrenceAdds a rule that excludes an occurrence for a specific date.
addMonthlyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a monthly basis.
addMonthlyRule()RecurrenceRuleAdds a rule that causes the event to recur on a monthly basis.
addWeeklyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a weekly basis.
addWeeklyRule()RecurrenceRuleAdds a rule that causes the event to recur on a weekly basis.
addYearlyExclusion()RecurrenceRuleAdds a rule that excludes occurrences on a yearly basis.
addYearlyRule()RecurrenceRuleAdds a rule that causes the event to recur on a yearly basis.
interval(interval)RecurrenceRuleConfigures the rule to only apply at this interval of the rule's time unit.
onlyInMonth(month)RecurrenceRuleConfigures the rule to only apply to a specific month.
onlyInMonths(months)RecurrenceRuleConfigures the rule to only apply to specific months.
onlyOnMonthDay(day)RecurrenceRuleConfigures the rule to only apply to a specific day of the month.
onlyOnMonthDays(days)RecurrenceRuleConfigures the rule to only apply to specific days of the month.
onlyOnWeek(week)RecurrenceRuleConfigures the rule to only apply to a specific week of the year.
onlyOnWeekday(day)RecurrenceRuleConfigures the rule to only apply to a specific day of the week.
onlyOnWeekdays(days)RecurrenceRuleConfigures the rule to only apply to specific days of the week.
onlyOnWeeks(weeks)RecurrenceRuleConfigures the rule to only apply to specific weeks of the year.
onlyOnYearDay(day)RecurrenceRuleConfigures the rule to only apply to a specific day of the year.
onlyOnYearDays(days)RecurrenceRuleConfigures the rule to only apply to specific days of the year.
setTimeZone(timeZone)EventRecurrenceSets the time zone for this recurrence.
times(times)RecurrenceRuleConfigures the rule to end after a given number of occurrences.
until(endDate)RecurrenceRuleConfigures the rule to end on a given date (inclusive).
weekStartsOn(day)RecurrenceRuleConfigures which day a week starts on, for the purposes of applying the rule.

Visibility

Properties

PropertyTypeDescription
CONFIDENTIALEnumThe event is private.
DEFAULTEnumUses the default visibility for events on the calendar.
PRIVATEEnumThe event is private and only event attendees may view event details.
PUBLICEnumThe event is public and event details are visible to all readers of the calendar.