Class Event
- java.lang.Object
-
- org.springframework.social.google.api.ApiEntity
-
- org.springframework.social.google.api.calendar.Event
-
public class Event extends ApiEntity
Model class representing an event within Google Calendar.See the reference documentation at https://developers.google.com/google-apps/calendar/v3/reference/events#resource.
- Author:
- Martin Wink
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classEvent.AttendeeDetails of an attendee of an event.static classEvent.CreatorInformation about the creator of an event.static classEvent.DateTimeTimezoneDetails of the start or end of an event.static classEvent.ExtendedPropertiesExtended properties of an event.static classEvent.GadgetA gadget that extends an event.static classEvent.OrganizerInformation about an event's organizer.static classEvent.ReminderOverrideDetails of the overrides to reminders.static classEvent.RemindersInformation about the event's reminders for the authenticated user.static classEvent.SourceSource from which an event was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol.
-
Constructor Summary
Constructors Modifier Constructor Description protectedEvent()Constructor protected so instances must be retrieved from Google Calendar itself.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description List<Event.Attendee>getAttendees()The attendees of this event.StringgetColorId()The colour of this event.DategetCreated()The creation time of this event.Event.CreatorgetCreator()The creator of this event.StringgetDescription()The description of this event.Event.DateTimeTimezonegetEnd()The (exclusive) end time of this event.Event.ExtendedPropertiesgetExtendedProperties()The extended properties of this event.Event.GadgetgetGadget()A gadget that extends this event.StringgetHangoutLink()An absolute link to the Google+ hangout associated with this event.StringgetHtmlLink()An absolute link to this event in the Google Calendar Web UI.StringgetiCalUid()This event's ID in the iCalendar format.StringgetLocation()The geographic location of this event as free-form text.Event.OrganizergetOrganizer()The organizer of this event.Event.DateTimeTimezonegetOriginalStartTime()For an instance of a recurring event, return the time at which this event would start according to the recurrence data in the recurring event identified byrecurringEventId.List<String>getRecurrence()A list of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event.StringgetRecurringEventId()For an instance of a recurring event, return this event ID of the recurring event itself.Event.RemindersgetReminders()Information about this event's reminders for the authenticated user.IntegergetSequence()The sequence number as per iCalendar.Event.SourcegetSource()The source of an event from which this event was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol.Event.DateTimeTimezonegetStart()The (inclusive) start time of this event.EventStatusgetStatus()The status of this event.StringgetSummary()The title of this event.TransparencygetTransparency()Whether this event blocks time on the calendar.DategetUpdated()The last modification time of this event.VisibilitygetVisibility()The visibility of this event.BooleanisAnyoneCanAddSelf()Whether anyone can invite themselves to this event.BooleanisAttendeesOmitted()Whether attendees may have been omitted from this event's representation.BooleanisEndTimeUnspecified()Whether the end time is actually unspecified.BooleanisGuestsCanInviteOthers()Whether attendees other than the organizer can invite others to this event.BooleanisGuestsCanModify()Whether attendees other than the organizer can modify this event.BooleanisGuestsCanSeeOtherGuests()Whether attendees other than the organizer can see who this event's attendees are.BooleanisLocked()Whether this is a locked event copy where no changes can be made to the main event fields "summary", "description", "location", "start", "end" or "recurrence".BooleanisPrivateCopy()Whether this is a private event copy where changes are not shared with other copies on other calendars.EventsetGuestsCanInviteOthers(Boolean guestsCanInviteOthers)Sets whether attendees other than the organizer can invite others to the event.EventsetGuestsCanSeeOtherGuests(Boolean guestsCanSeeOtherGuests)Sets whether attendees other than the organizer can see who the event's attendees are.EventsetLocation(String location)Sets the location of this event.EventsetRecurrence(List<String> list)Replaces the list of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event.EventsetStatus(EventStatus status)Sets the status of this event.EventsetSummary(String summary)Sets the title of this event.
-
-
-
Method Detail
-
getStatus
public EventStatus getStatus()
The status of this event.- Returns:
- the value or
nullif none.
-
setStatus
public Event setStatus(EventStatus status)
Sets the status of this event.- Parameters:
status- the new status, ornullfor none.- Returns:
- this event, for chaining.
-
getHtmlLink
public String getHtmlLink()
An absolute link to this event in the Google Calendar Web UI.- Returns:
- the value or
nullif none.
-
getCreated
public Date getCreated()
The creation time of this event.- Returns:
- the value or
nullif none.
-
getUpdated
public Date getUpdated()
The last modification time of this event.- Returns:
- the value or
nullif none.
-
getSummary
public String getSummary()
The title of this event.- Returns:
- the value or
nullif none.
-
setSummary
public Event setSummary(String summary)
Sets the title of this event.- Parameters:
summary- the new title.- Returns:
- this event, to allow chaining.
-
getDescription
public String getDescription()
The description of this event.- Returns:
- the value or
nullif none.
-
getLocation
public String getLocation()
The geographic location of this event as free-form text.- Returns:
- the value or
nullif none.
-
setLocation
public Event setLocation(String location)
Sets the location of this event.- Parameters:
location- the new location, ornullfor none.- Returns:
- this event, to allow chaining.
-
getColorId
public String getColorId()
The colour of this event.- Returns:
- the value or
nullif none.
-
getCreator
public Event.Creator getCreator()
The creator of this event.- Returns:
- the value or
nullif none.
-
getOrganizer
public Event.Organizer getOrganizer()
The organizer of this event. If the organizer is also an attendee, this is indicated with a separate entry in attendees with the organizer field set to True.- Returns:
- the value or
nullif none.
-
getStart
public Event.DateTimeTimezone getStart()
The (inclusive) start time of this event. For a recurring event, this is the start time of the first instance.- Returns:
- the value or
nullif none.
-
getEnd
public Event.DateTimeTimezone getEnd()
The (exclusive) end time of this event. For a recurring event, this is the end time of the first instance.- Returns:
- the value or
nullif none.
-
isEndTimeUnspecified
public Boolean isEndTimeUnspecified()
Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set totrue. Iftrue, the end time should be disregarded.- Returns:
- the value or
nullif none.
-
getRecurringEventId
public String getRecurringEventId()
For an instance of a recurring event, return this event ID of the recurring event itself.- Returns:
- the value or
nullif none.
-
getOriginalStartTime
public Event.DateTimeTimezone getOriginalStartTime()
For an instance of a recurring event, return the time at which this event would start according to the recurrence data in the recurring event identified byrecurringEventId.- Returns:
- the value or
nullif none.
-
getTransparency
public Transparency getTransparency()
Whether this event blocks time on the calendar.- Returns:
- the value or
nullif none.
-
getVisibility
public Visibility getVisibility()
The visibility of this event.- Returns:
- the value or
nullif none.
-
getiCalUid
public String getiCalUid()
This event's ID in the iCalendar format.- Returns:
- the value or
nullif none.
-
getSequence
public Integer getSequence()
The sequence number as per iCalendar.- Returns:
- the value or
nullif none.
-
isAttendeesOmitted
public Boolean isAttendeesOmitted()
Whether attendees may have been omitted from this event's representation. When retrieving an event, this may be due to a restriction specified by the maxAttendee query parameter.- Returns:
- the value or
nullif none.
-
getHangoutLink
public String getHangoutLink()
An absolute link to the Google+ hangout associated with this event.- Returns:
- the value or
nullif none.
-
isAnyoneCanAddSelf
public Boolean isAnyoneCanAddSelf()
Whether anyone can invite themselves to this event.- Returns:
- the value or
nullif none.
-
isGuestsCanInviteOthers
public Boolean isGuestsCanInviteOthers()
Whether attendees other than the organizer can invite others to this event.- Returns:
- the value or
nullif none.
-
isGuestsCanModify
public Boolean isGuestsCanModify()
Whether attendees other than the organizer can modify this event.- Returns:
- the value or
nullif none.
-
isGuestsCanSeeOtherGuests
public Boolean isGuestsCanSeeOtherGuests()
Whether attendees other than the organizer can see who this event's attendees are.- Returns:
- the value or
nullif none.
-
isPrivateCopy
public Boolean isPrivateCopy()
Whether this is a private event copy where changes are not shared with other copies on other calendars.- Returns:
- the value or
nullif none.
-
isLocked
public Boolean isLocked()
Whether this is a locked event copy where no changes can be made to the main event fields "summary", "description", "location", "start", "end" or "recurrence".- Returns:
- the value or
nullif none.
-
getRecurrence
public List<String> getRecurrence()
A list of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event. This field is omitted for single events or instances of recurring events.- Returns:
- the value or
nullif none.
-
setRecurrence
public Event setRecurrence(List<String> list)
Replaces the list of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event.- Parameters:
list- the new list, ornullfor none.- Returns:
- this event, to allow chaining.
-
getAttendees
public List<Event.Attendee> getAttendees()
The attendees of this event.- Returns:
- the value or
nullif none.
-
getExtendedProperties
public Event.ExtendedProperties getExtendedProperties()
The extended properties of this event.- Returns:
- the value or
nullif none.
-
getGadget
public Event.Gadget getGadget()
A gadget that extends this event.- Returns:
- the value or
nullif none.
-
getReminders
public Event.Reminders getReminders()
Information about this event's reminders for the authenticated user.- Returns:
- the value or
nullif none.
-
getSource
public Event.Source getSource()
The source of an event from which this event was created; for example a web page, an email message or any document identifiable by an URL using HTTP/HTTPS protocol. Accessible only by the creator of this event.- Returns:
- the value or
nullif none.
-
setGuestsCanInviteOthers
public Event setGuestsCanInviteOthers(Boolean guestsCanInviteOthers)
Sets whether attendees other than the organizer can invite others to the event.- Parameters:
guestsCanInviteOthers- the new value.- Returns:
- this event, to allow chaining.
-
-